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

正则表达式迭代器 (类模板)