<regex>

定义一个类模板来分析正则表达式 (C++)，以及定义多个类模板和函数以在文本中搜索正则表达式对象的匹配项。

语法

#include <regex>

备注

若要创建正则表达式对象，请将类模板 basic_regex 类或其专用化（regex 和 wregex）之一与类型为 regex_constants::syntax_option_type 的语法标志一起使用。

若要在文本中搜索正则表达式对象的匹配项，请将模板函数 regex_match 和 regex_search 与类型为 regex_constants::match_flag_type 的匹配项标志一起使用。 这些函数通过将类模板 match_results 类及其专用化（cmatch、wcmatch、smatch 和 wsmatch）与类模板 sub_match 类及其专用化（csub_match、wcsub_match、ssub_match 和 wssub_match）一起使用来返回结果。

若要替换匹配正则表达式对象的文本，请将模板函数 regex_replace 与类型为 regex_constants::match_flag_type 的匹配项标志一起使用。

若要循环访问正则表达式对象的多个匹配项，请将类模板 regex_iterator 类和 regex_token_iterator 类或其专用化（cregex_iterator、sregex_iterator、wcregex_iterator、wsregex_iterator、cregex_token_iterator、sregex_token_iterator、wcregex_token_iterator 或 wsregex_token_iterator）之一与类型为 regex_constants::match_flag_type 的匹配项标志一起使用。

若要修改正则表达式语法的详细信息，请编写一个实现正则表达式特征的类。

类

类	说明
basic_regex	包装正则表达式。
match_results	包含一系列子匹配项。
regex_constants	包含各种类型的常量。
regex_error	报告错误的正则表达式。
regex_iterator	循环访问匹配结果。
regex_traits	描述用于匹配的元素的特征。
regex_traits<char>	描述用于匹配的 char 的特征。
regex_traits<wchar_t>	描述用于匹配的 wchar_t 的特征。
regex_token_iterator	循环访问子匹配项。
sub_match	介绍子匹配项。

类型定义

名称	描述
cmatch	的类型定义。char match_results
cregex_iterator	的类型定义。char regex_iterator
cregex_token_iterator	的类型定义。char regex_token_iterator
csub_match	的类型定义。char sub_match
regex	的类型定义。char basic_regex
smatch	的类型定义。string match_results
sregex_iterator	的类型定义。string regex_iterator
sregex_token_iterator	的类型定义。string regex_token_iterator
ssub_match	的类型定义。string sub_match
wcmatch	的类型定义。wchar_t match_results
wcregex_iterator	的类型定义。wchar_t regex_iterator
wcregex_token_iterator	的类型定义。wchar_t regex_token_iterator
wcsub_match	的类型定义。wchar_t sub_match
wregex	的类型定义。wchar_t basic_regex
wsmatch	的类型定义。wstring match_results
wsregex_iterator	的类型定义。wstring regex_iterator
wsregex_token_iterator	的类型定义。wstring regex_token_iterator
wssub_match	的类型定义。wstring sub_match

函数

函数	说明
regex_match	与正则表达式完全匹配。
regex_replace	替换匹配正则表达式。
regex_search	搜索正则表达式匹配项。
swap	交换 basic_regex 或 match_results 对象。

运算符

运算符	说明
operator==	比较各种对象，相等。
operator!=	比较各种对象，不相等。
operator<	比较各种对象，小于。
operator\<=	比较各种对象，小于或等于。
operator>	比较各种对象，大于。
operator>=	比较各种对象，大于或等于。
operator<<	将 sub_match 插入流中。

另请参阅

正则表达式 (C++)
regex_constants 类
regex_error 类
<regex> 函数
regex_iterator 类
<regex> 运算符
regex_token_iterator 类
regex_traits 类
<regex> typedef