std::match_results

 

C++

编译器支持

独立式和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库 (C++11)

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

原始数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码标识

text_encoding (C++26)

 

正则表达式库

类

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

算法

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

迭代器

regex_iterator (C++11)

regex_token_iterator (C++11)

异常

regex_error (C++11)

特性

regex_traits (C++11)

常量

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

正则表达式语法

修改后的 ECMAScript-262 (C++11)

 

std::match_results

成员函数

match_results::match_results

match_results::~match_results

match_results::operator=

match_results::get_allocator

状态

match_results::ready

元素访问

match_results::size

match_results::max_size

match_results::empty

match_results::length

match_results::position

match_results::str

match_results::operator[]

match_results::prefix

match_results::suffix

迭代器

match_results::beginmatch_results::cbegin

match_results::endmatch_results::cend

格式化

match_results::format

修改器

match_results::swap

非成员函数

operator==operator!= (直到 C++20)

swap(std::match_results)

 

定义于头文件 <regex>
template<     class BidirIt,     class Alloc = std::allocator<std::sub_match<BidirIt>> > class match_results;	(1)	(自 C++11 起)
namespace pmr {     template <class BidirIt>     using match_results = std::match_results<BidirIt,                               std::pmr::polymorphic_allocator<                                   std::sub_match<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>

成员函数

(构造函数)	构造对象 (公有成员函数)
(析构函数)	析构对象 (公有成员函数)
operator=	赋值内容 (公有成员函数)
get_allocator	返回关联的分配器 (公有成员函数)
状态
ready	检查结果是否可用 (公有成员函数)
大小
empty	检查匹配是否成功 (公有成员函数)
size	返回完全建立的结果状态中的匹配数 (公有成员函数)
max_size	返回子匹配的最大可能数量 (公有成员函数)
元素访问
length	返回特定子匹配的长度 (公有成员函数)
position	返回特定子匹配的第一个字符的位置 (公有成员函数)
str	返回特定子匹配的字符序列 (公有成员函数)
operator[]	返回指定的子匹配 (公有成员函数)
prefix	返回目标序列的开头和完整匹配的开头之间的子序列 (公有成员函数)
suffix	返回完整匹配的结尾和目标序列的结尾之间的子序列 (公有成员函数)
迭代器
begincbegin	返回指向子匹配列表开头的迭代器 (公有成员函数)
endcend	返回指向子匹配列表结尾的迭代器 (公有成员函数)
格式化
format	格式化匹配结果以进行输出 (公有成员函数)
修改器
swap	交换内容 (公有成员函数)

非成员函数

operator==operator!= (在 C++20 中移除)	按字典序比较两个匹配结果中的值 (函数模板)
std::swap(std::match_results) (C++11)	特化 std::swap 算法 (函数模板)