std::regex_replace

来自cppreference.com
< cpp‎ | regex

该页由英文版wiki使用Google Translate机器翻译而来。

该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里.

点击这里参见该页的英文版本

 
C++
 
正则表达式库
类
(C++11)
(C++11)
(C++11)
算法
(C++11)
(C++11)
regex_replace
(C++11)
迭代器
(C++11)
(C++11)
异常
(C++11)
特性
(C++11)
常量
(C++11)
(C++11)
(C++11)
正则表达式文法
(C++11)
 
定义于头文件 <regex>
template< class OutputIt, class BidirIt,

          class Traits, class CharT,
          class STraits, class SAlloc >
OutputIt regex_replace( OutputIt out, BidirIt first, BidirIt last,
                        const std::basic_regex<CharT,Traits>& e,
                        const std::basic_string<CharT,STraits,SAlloc>& fmt,
                        std::regex_constants::match_flag_type flags =

                            std::regex_constants::match_default );
 (1) (C++11 起)
template< class OutputIt, class BidirIt,

          class Traits, class CharT >
OutputIt regex_replace( OutputIt out, BidirIt first, BidirIt last,
                        const std::basic_regex<CharT,Traits>& e,
                        const CharT* fmt,
                        std::regex_constants::match_flag_type flags =

                            std::regex_constants::match_default );
 (2) (C++11 起)
template< class Traits, class CharT,

          class STraits, class SAlloc,
          class FTraits, class FAlloc >
std::basic_string<CharT,STraits,SAlloc>
    regex_replace( const std::basic_string<CharT,STraits,SAlloc>& s,
                   const std::basic_regex<CharT,Traits>& e,
                   const std::basic_string<CharT,FTraits,FAlloc>& fmt,
                   std::regex_constants::match_flag_type flags =

                       std::regex_constants::match_default );
 (3) (C++11 起)
template< class Traits, class CharT,

          class STraits, class SAlloc >
std::basic_string<CharT,STraits,SAlloc>
    regex_replace( const std::basic_string<CharT,STraits,SAlloc>& s,
                   const std::basic_regex<CharT,Traits>& e,
                   const CharT* fmt,
                   std::regex_constants::match_flag_type flags =

                       std::regex_constants::match_default );
 (4) (C++11 起)
template< class Traits, class CharT,

          class STraits, class SAlloc >
std::basic_string<CharT>
    regex_replace( const CharT* s,
                   const std::basic_regex<CharT,Traits>& e,
                   const std::basic_string<CharT,STraits,SAlloc>& fmt,
                   std::regex_constants::match_flag_type flags =

                       std::regex_constants::match_default );
 (5) (C++11 起)
template< class Traits, class CharT >

std::basic_string<CharT>
    regex_replace( const CharT* s,
                   const std::basic_regex<CharT,Traits>& e,
                   const CharT* fmt,
                   std::regex_constants::match_flag_type flags =

                       std::regex_constants::match_default );
 (6) (C++11 起)
1)
构造一个std::regex_iteratori仿佛std::regex_iterator<BidirIt, CharT, traits> i(first, last, e, flags)的对象，并使用它通过序列e在每场比赛的[first,last)步骤。对于每一次这样的比赛m，不匹配的序列（m.prefix()）复制到out是替换字符串的格式化，然后替换匹配的序列，如果通过调用m.format(out, fmt, flags)。如果没有找到匹配项，其余的非匹配的字符复制到out.
原文：
Constructs a std::regex_iterator object i as if by std::regex_iterator<BidirIt, CharT, traits> i(first, last, e, flags), and uses it to step through every match of e within the sequence [first,last). For each such match m, copies the non-matched subsequence (m.prefix()) into out as-is and then replaces the matched subsequence with the formatted replacement string as if by calling m.format(out, fmt, flags). When no more matches are found, copies the remaining non-matched characters to out.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
如果没有匹配，将整个序列转换成out是的
原文：
If there are no matches, copies the entire sequence into out as-is.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
如果flags包含std::regex_constants::format_no_copy，不会被复制到不匹配的子序列out.
原文：
If flags contains std::regex_constants::format_no_copy, the non-matched subsequences are not copied into out.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
flags包含std::regex_constants::format_first_only，只有第一场比赛被替换.
原文：
If flags contains std::regex_constants::format_first_only, only the first match is replaced.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
2)
为1相同），但格式化的更换进行，仿佛通过调用m.format(out, fmt, fmt + char_traits<charT>::length(fmt), flags)
原文：
same as 1), but the formatted replacement is performed as if by calling m.format(out, fmt, fmt + char_traits<charT>::length(fmt), flags)
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3-4)
result类型std::basic_string<CharT, ST, SA>构造一个空字符串，并调用std::regex_replace(std::back_inserter(result), s.begin(), s.end(), e, fmt, flags).
原文：
Constructs an empty string result of type std::basic_string<CharT, ST, SA> and calls std::regex_replace(std::back_inserter(result), s.begin(), s.end(), e, fmt, flags).
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
5-6)
result类型std::basic_string<CharT>构造一个空字符串，并调用std::regex_replace(std::back_inserter(result), s, s + std::char_traits<CharT>::length(s), e, fmt, flags).
原文：
Constructs an empty string result of type std::basic_string<CharT> and calls std::regex_replace(std::back_inserter(result), s, s + std::char_traits<CharT>::length(s), e, fmt, flags).
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 参数

first, last -
输入字符序列，表示为一对迭代器
原文：
the input character sequence, represented as a pair of iterators
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
s -
输入字符序列，如std :: basic_string的字符数组表示
原文：
the input character sequence, represented as std::basic_string or character array
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
e -
的std ::的basic_regex，将输入序列进行匹配
原文：
the std::basic_regex that will be matched against the input sequence
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
flags -
匹配标志的类型std::regex_constants::match_flag_type
原文：
the match flags of type std::regex_constants::match_flag_type
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
fmt -
正则表达式替换格式字符串，确切语法取决于flags的价值
原文：
the regex replacement format string, exact syntax depends on the value of flags
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
out -
输出迭代器来存储结果的更换
原文：
output iterator to store the result of the replacement
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
类型要求
-
OutputIt 必须满足 OutputIterator 的要求。
-
BidirIt 必须满足 BidirectionalIterator 的要求。

[编辑] 返回值

1-2)
返回的副本输出迭代器out.
原文：
Returns a copy of the output iterator out.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3-6)
返回的字符串result包含输出.
原文：
Returns the string result which contains the output.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 例外

可能会引发std::regex_error表示错误条件.
原文：
May throw std::regex_error to indicate an 错误条件.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 示例

运行此代码
#include <iostream>
#include <regex>
#include <string>
int main()
{
   std::string text = "Quick brown fox";
   std::regex vowel_re("a|o|e|u|i");
   std::cout << std::regex_replace(text, vowel_re, "[$&]") << '\n';
}

输出： 

Q[u][i]ck br[o]wn f[o]x

[编辑] 另请参阅

(C++11)
 试图匹配正则表达式到字符序列的任何部分
(函数模板) [编辑]
(C++11)
 特定于匹配的选项
(typedef) [编辑]
来自“http://zh.cppreference.com/mwiki/index.php?title=cpp/regex/regex_replace&oldid=38513”