C++

参考

<regex>

match_results

类模板
<regex>

std::match_results

template < class BidirectionalIterator,           class Alloc = allocator< sub_match<BidirectionalIterator> > >  class match_results;
匹配结果
一个类似容器的类，用于在*正则表达式匹配操作*后存储目标字符序列中找到的匹配项，每个匹配项都是相应的sub_match类型。

它由regex_match、regex_search或regex_iterator自动填充匹配操作的结果。中的元素match_results对象被限定为const，因此不打算在这些函数之外修改。

构造时，match_results对象没有结果状态（即它们不是ready）。一旦它们在调用regex_match或regex_search时作为正确参数使用，它们就会获得已建立的结果状态，并变为ready（可以通过调用成员函数match_results::ready来检查）。指向有效位置的regex_iterator的解引用值始终是ready。

一旦ready，对象可以为空（empty）或非空（non-empty），具体取决于目标序列是否成功匹配表达式。如果成功，它不是空的（non-empty），并且包含一系列sub_match对象：第一个sub_match元素对应整个匹配，并且，如果regex表达式包含要匹配的子表达式（即括号分隔的组），则它们相应的子匹配存储在match_results对象中作为连续的sub_match元素。

这些子匹配可以像match_results对象一样被视为容器进行访问，或者直接使用str、length或position等成员进行访问。

如果match_results如果使用regex_search与regex一起使用match_results对象，则可以使用prefix和suffix成员来访问未匹配目标序列的部分。

对象match_results类型且ready的对象也可以使用成员函数match_results::format来使用它们包含的信息format一个字符序列。

类cmatch和smatch是这个类对于窄字符（char）的实例化。wcmatch和wsmatch是它们各自的宽字符版本（wchar_t）。在<regex>标准头文件中定义
1
2
3
4
 
typedef match_results<const char*> cmatch;
typedef match_results<const wchar_t*> wcmatch;
typedef match_results<string::const_iterator> smatch;
typedef match_results<wstring::const_iterator> wsmatch;

模板参数

BidirectionalIterator
一个双向迭代器类型，用于迭代字符的目标序列。
Alloc
用于定义存储分配模型的分配器对象的类型。默认情况下，allocator类模板用于sub_match类型的元素，它定义了这些对象最简单的内存分配模型，并且与值无关。
别名为成员类型match_results::allocator_type.

sub_match for string literals (class)

cmatch
字符串字面量的match_results (class)
smatch
字符串对象的match_results (class)
wcmatch
宽字符串字面量的match_results (class)
wsmatch
宽字符串对象的match_results (class)

成员类型

以下别名是match_results的成员类型。它们被成员函数广泛用作参数和返回类型。

成员类型定义说明
value_typesub_match<BidirectionalIterator>存储的元素的类型（sub_match）。
char_typeiterator_traits<BidirectionalIterator>::value_type序列中字符的类型。
string_typebasic_string<char_type>字符类型的string的类型。
allocator_type第二个模板参数 (Alloc)默认为allocator<value_type>
引用const value_type&
const_referenceconst value_type&
iterator一个指向const value_type
const_iterator一个指向const value_type与iterator相同
size_typeiterator_traits<BidirectionalIterator>::difference_type的无符号整数类型，通常与 size_t 一样
difference_typeiterator_traits<BidirectionalIterator>::size_type相同，通常与 ptrdiff_t 一样
成员类型定义说明
value_typesub_match<BidirectionalIterator>存储的元素的类型（sub_match）。
char_typeiterator_traits<BidirectionalIterator>::value_type序列中字符的类型。
string_typebasic_string<char_type>字符类型的string的类型。
allocator_type第二个模板参数 (Alloc)默认为allocator<value_type>
引用value_type&
const_referenceconst value_type&
iterator一个指向const value_type
const_iterator一个指向const value_type与iterator相同
size_typeiterator_traits<BidirectionalIterator>::difference_type的无符号整数类型，通常与 size_t 一样
difference_typeiterator_traits<BidirectionalIterator>::size_type相同，通常与 ptrdiff_t 一样

成员函数

（构造函数）
构造match_results (public member function)
(析构函数)
销毁match_results (public member function)
operator=
将值赋给match_results (public member function)

容量

empty
测试对象是否没有匹配 (public member function)
size
返回匹配数 (公共成员函数)
max_size
返回最大大小 (公开成员函数)

迭代器

begin
返回指向起始位置的迭代器 (公开成员函数)
end
返回指向末尾的迭代器 (公开成员函数)
cbegin
返回指向起始位置的 const_iterator (公开成员函数)
cend
返回指向末尾的 const_iterator (公开成员函数)

元素访问

operator[]
返回匹配项（公共成员函数）
前缀
返回前缀 (public member function)
suffix
返回后缀 (public member function)
长度
返回匹配长度（公共成员函数）
position
返回匹配的位置 (public member function)
str
将匹配项作为字符串返回 (public member function)

格式化

format
格式化替换字符串 (public member function)

Swap

swap
交换内容 (公开成员函数)

观察器

就绪
测试结果是否准备好 (public member function)
get_allocator
获取分配器 (公开成员函数)

非成员函数

operators (match_results)
match_results 的关系运算符 (function template)
swap (match_results)
交换两个match_result对象的内容 (function template)