std::sub_match

定义于头文件 <regex>
template<     class BidirIt > class sub_match;		(C++11 起)

正则表达式引擎用类模板 sub_match ，表示有标记子表达式所匹配的字符序列。 匹配是目标范围中匹配正则表达式的 [begin, end) 对，不过拥有附加的观察器函数以增进代码清晰度。

只有默认构造函数是可公开访问的。在处理 regex 算法之一期间， sub_match 的实例作为 std::match_results 容器的一部分正常构造并移居。

成员函数返回定义的默认值，除非 matched 成员为 true 。

sub_match 继承自 std::pair<BidirIt, BidirIt> ，尽管它不能当做 std::pair 对象，因为成员函数，如交换与赋值，不会按期待工作。

类型要求

- BidirIt 必须满足遗留双向迭代器 (LegacyBidirectionalIterator) 的要求。

特化

为常见字符类型提供数个特化：

定义于头文件 <regex>
类型	定义
csub_match	sub_match<const char*>
wcsub_match	sub_match<const wchar_t*>
ssub_match	sub_match<std::string::const_iterator>
wssub_match	sub_match<std::wstring::const_iterator>

成员类型

成员类型	定义
iterator	BidirIt
value_type	std::iterator_traits<BidirIt>::value_type
difference_type	std::iterator_traits<BidirIt>::difference_type
string_type	std::basic_string<value_type>

成员对象

bool matched

指示此匹配是否成功 (公开成员对象)

成员函数

(构造函数)	构造匹配对象 (公开成员函数)
观察器
length	若存在则返回匹配的长度 (公开成员函数)
stroperator string_type	转换为底层字符串类型 (公开成员函数)
compare	若存在则比较匹配的子序列 (公开成员函数)

非成员函数

operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20)	比较一个 sub_match 与另一 sub_match 、字符串或字符 (函数模板)
operator<<	输出匹配的字符序列 (函数模板)

参阅

regex_token_iterator (C++11)

在正则表达式子匹配上迭代 (类模板)