std::sub_match

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (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::sub_match

成员函数

sub_match::sub_match

sub_match::length

sub_match::strsub_match::operator string_type

sub_match::compare

sub_match::swap

非成员函数

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

operator<<

 

在头文件 <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	匹配序列的结束（过一） (公有成员对象)

成员函数

(构造函数)	构造匹配对象 (公共成员函数)
观察器
length	返回匹配的长度（如果有） (公共成员函数)
stroperator string_type	转换为底层字符串类型 (公共成员函数)
compare	比较匹配的子序列（如果有） (公共成员函数)
修改器
swap	交换内容 (公共成员函数)

非成员函数

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

示例

运行此代码

#include <cassert>
#include <iostream>
#include <regex>
#include <string>
 
int main()
{
    std::string sentence{"Friday the thirteenth."};
    const std::regex re{"([A-z]+) ([a-z]+) ([a-z]+)"};
    std::smatch words;
    std::regex_search(sentence, words, re);
    std::cout << std::boolalpha;
    for (const auto& m : words)
    {
        assert(m.matched);
        std::cout << "m: [" << m << "], m.length(): " << m.length() << ", "
                     "*m.first: '" << *m.first << "', "
                     "*m.second: '" << *m.second << "'\n";
    }
}

输出

m: [Friday the thirteenth], m.length(): 21, *m.first: 'F', *m.second: '.'
m: [Friday], m.length(): 6, *m.first: 'F', *m.second: ' '
m: [the], m.length(): 3, *m.first: 't', *m.second: ' '
m: [thirteenth], m.length(): 10, *m.first: 't', *m.second: '.'

参见

regex_token_iterator (C++11)

迭代给定字符串中所有正则表达式匹配中指定的子表达式或未匹配的子字符串 (类模板)