std::regex_replace

引數

s

包含目標序列（主題）的字串。

rgx

一個用於匹配的basic_regex物件（模式）。

fmt

包含每次匹配替換的字串。
這可能包含格式說明符和轉義序列，它們將被表示的字元替換。對於format_default，可能的說明符是

字元	替換內容
$n	n次反向引用（即，與正則表示式模式中用括號指定的第n個匹配組的副本）。 n必須是一個整數值，表示一個有效的反向引用，大於0，最多兩位數。
$&	整個匹配的副本
$`	字首（即，目標序列中位於匹配之前的部分）。
$´	字尾（即，目標序列中位於匹配之後的部分）。
$$	單個$字元。

標誌

用於控制rgx如何匹配以及fmt如何格式化的標誌。
這些常量可以一個或多個（使用按位或運算子 |）組合，形成一個有效的位掩碼值，型別為regex_constants::match_flag_type:

flag*	effects	說明
match_default	預設	預設匹配行為。 此常量的值為零**。
match_not_bol	非行首	第一個字元不被視為行首（"^"不匹配）。
match_not_eol	非行尾	最後一個字元不被視為行尾（"$"不匹配）。
match_not_bow	非詞首	轉義序列"\b"不匹配作為詞首。
match_not_eow	非詞尾	轉義序列"\b"不匹配作為詞尾。
match_any	任何匹配	如果可能存在多個匹配，則接受任何匹配。
match_not_null	非空	空序列不匹配。
match_continuous	連續	表示式必須匹配以第一個字元開始的子序列。 子序列必須以第一個字元開始才能匹配。
match_prev_avail	先前可用	第一個字元之前存在一個或多個字元。（match_not_bol和match_not_bow被忽略)
format_default	預設格式	使用標準的格式化規則替換匹配項（ECMAScript的replace方法使用的規則）。 此常量的值為零**。
format_sed	sed 格式	使用與 POSIX 中 sed 實用程式相同的規則來替換匹配項。
format_no_copy	不復制	替換匹配項時，不會複製目標序列中與正則表示式不匹配的部分。
format_first_only	僅首次	僅替換正則表示式的第一次出現。

* 這些位掩碼標誌名稱可在std::regex_constants名稱空間下找到（更多詳情請參見regex_constants）。
** 值為零的常量如果設定了其他標誌，則會被忽略。
match_flag_type是一個可在std::regex_constants名稱空間內定義。

下可用的型別

輸出迭代器型別的型別，指向序列的第一個字元，結果序列儲存在那裡。
函式模板型別可以是任何型別的輸出迭代器到字元。

first, last

雙向迭代器，指向用作匹配目標序列的字元範圍的起始和結束位置。使用的範圍是[first,last)，其中包括first和last之間的所有字元，包括first指向的字元，但不包括last指向的字元。
函式模板型別可以是任何指向字元的雙向迭代器。

返回值

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

// regex_replace example
#include <iostream>
#include <string>
#include <regex>
#include <iterator>

int main ()
{
  std::string s ("there is a subsequence in the string\n");
  std::regex e ("\\b(sub)([^ ]*)");   // matches words beginning by "sub"

  // using string/c-string (3) version:
  std::cout << std::regex_replace (s,e,"sub-$2");

  // using range/c-string (6) version:
  std::string result;
  std::regex_replace (std::back_inserter(result), s.begin(), s.end(), e, "$2");
  std::cout << result;

  // with flags:
  std::cout << std::regex_replace (s,e,"$1 and $2",std::regex_constants::format_no_copy);
  std::cout << std::endl;

  return 0;
}

there is a sub-sequence in the string
there is a sequence in the string
sub and sequence

另見

regex_match

匹配序列 (函式模板)

regex_search

搜尋序列 (函式模板)

regex_iterator

正則表示式迭代器 (類模板)