std::match_results
| 在头文件 <regex> 中定义 |
||
| template< class BidirIt, |
(1) | (C++11 起) |
| namespace pmr { template <class BidirIt> |
(2) | (C++17 起) |
类模板 std::match_results 包含表示正则表达式匹配结果的字符序列集合。
这是一个专门的、感知分配器的容器。它只能通过默认创建、从 std::regex_iterator 获取，或由 std::regex_search 或 std::regex_match 修改。由于 std::match_results 包含 std::sub_match，其中每个都是指向原始匹配字符序列的迭代器对，如果原始字符序列被销毁或其迭代器因其他原因失效，则检查 std::match_results 会导致未定义行为。
std::match_result 中包含的第一个 std::sub_match（索引 0）总是表示正则表达式在目标序列中完成的完整匹配，随后的 std::sub_match 表示子表达式匹配，其顺序与正则表达式中分隔子表达式的左括号对应。
std::match_results 满足 AllocatorAwareContainer 和 SequenceContainer 的要求，但只支持复制赋值、移动赋值和为常量容器定义的运算，并且比较函数的语义与容器的要求不同。
目录 |
[编辑] 类型要求
-BidirIt 必须满足 LegacyBidirectionalIterator 的要求。 | ||
-Alloc 必须满足 Allocator 的要求。 |
[编辑] 特化
提供了几种常见字符序列类型的特化
| 在头文件
<regex> 中定义 | |
| 类型 | 定义 |
std::cmatch
|
std::match_results<const char*> |
std::wcmatch
|
std::match_results<const wchar_t*> |
std::smatch
|
std::match_results<std::string::const_iterator> |
std::wsmatch
|
std::match_results<std::wstring::const_iterator> |
std::pmr::cmatch (C++17) |
std::pmr::match_results<const char*> |
std::pmr::wcmatch (C++17) |
std::pmr::match_results<const wchar_t*> |
std::pmr::smatch (C++17) |
std::pmr::match_results<std::string::const_iterator> |
std::pmr::wsmatch (C++17) |
std::pmr::match_results<std::wstring::const_iterator> |
[编辑] 成员类型
| 成员类型 | 定义 |
allocator_type
|
Allocator
|
value_type
|
std::sub_match<BidirIt> |
const_reference
|
const value_type& |
reference
|
value_type&
|
const_iterator
|
实现定义（取决于底层容器） |
iterator
|
const_iterator
|
difference_type
|
std::iterator_traits<BidirIt>::difference_type |
size_type
|
std::allocator_traits<Alloc>::size_type |
char_type
|
std::iterator_traits<BidirIt>::value_type |
string_type
|
std::basic_string<char_type> |
[编辑] 成员函数
| 构造对象 (public member function) | |
| 析构对象 (public member function) | |
| 赋值内容 (public member function) | |
| 返回关联的分配器 (public member function) | |
状态 | |
| 检查结果是否可用 (公开成员函数) | |
大小 | |
| 检查匹配是否成功 (public member function) | |
| 在完全建立结果状态时返回匹配的数量 (public member function) | |
| 返回子匹配的最大可能数量 (public member function) | |
元素访问 | |
| 返回特定子匹配的长度 (public member function) | |
| 返回特定子匹配的第一个字符的位置 (public member function) | |
| 返回特定子匹配的字符序列 (public member function) | |
| 返回指定的子匹配 (public member function) | |
| 返回目标序列开头与完整匹配开头之间的子序列 (public member function) | |
| 返回完整匹配结束与目标序列结束之间的子序列 (public member function) | |
迭代器 | |
| 返回子匹配列表开头的迭代器 (public member function) | |
| 返回子匹配列表末尾的迭代器 (public member function) | |
格式 | |
| 格式化匹配结果以供输出 (public member function) | |
修改器 | |
| 交换内容 (public member function) | |
[编辑] 非成员函数
| (在 C++20 中移除) |
按字典顺序比较两个匹配结果中的值 (函数模板) |
| 特化 std::swap 算法 (函数模板) |
