std::sub_match
|
在标头
<regex> 定义 |
||
|
template<class BidirIt>
class sub_match; |
(C++11 起) | |
正则表达式引擎用类模板 std::sub_match 表示有标记子表达式所匹配的字符序列。 匹配是目标范围中匹配正则表达式的 [begin, end) 对，不过拥有附加的观察器函数以增进代码清晰度。
只有默认构造函数是可公开访问的。在处理正则表达式算法期间，std::sub_match 的实例作为 std::match_results 容器的一部分正常构造并移居。
成员函数返回定义的默认值，除非 matched 成员是 true。
std::sub_match 继承自 std::pair<BidirIt, BidirIt>，尽管它不能当做 std::pair 对象，因为成员函数，如赋值，不会有预计效果。
类型要求
-
BidirIt 必须满足老式双向迭代器 (LegacyBidirectionalIterator) 。 |
特化
为常见字符类型提供数个特化：
|
在标头
<regex> 定义 |
|
| 类型 | 定义 |
std::csub_match |
std::sub_match<const char*> |
std::wcsub_match |
std::sub_match<const wchar_t*> |
std::ssub_match |
std::sub_match<std::string::const_iterator> |
std::wssub_match |
std::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
|
指示此匹配是否成功 (公开成员对象) |
继承自 std::pair
|
BidirIt first
|
匹配序列的开始。 (公开成员对象) |
|
BidirIt second
|
匹配序列的结尾后一位置。 (公开成员对象) |
成员函数
| 本节未完成 原因：Apply LWG 3204, add the swap() member function |
| 构造匹配对象 (公开成员函数) |
|
观察器 |
|
| 若存在则返回匹配的长度 (公开成员函数) |
|
| 转换为底层字符串类型 (公开成员函数) |
|
| 若存在则比较匹配的子序列 (公开成员函数) |
|
非成员函数
|
(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20)
|
比较一个 sub_match 与另一 sub_match 、字符串或字符(函数模板) |
| 输出匹配的字符子序列 (函数模板) |
参阅
|
(C++11)
|
迭代给定字符串中的所有正则表达式匹配中的指定子表达式，或迭代未匹配的子字符串 (类模板) |