std::sub_match

来自cppreference.com
< cpp‎ | regex
 
C++
 
文本处理库
 
正则表达式库
类
(C++11)
sub_match
(C++11)
(C++11)
算法
(C++11)
(C++11)
(C++11)
迭代器
(C++11)
(C++11)
异常
(C++11)
特征
(C++11)
常量
(C++11)
(C++11)
(C++11)
正则表达式文法
(C++11)
 
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
 匹配序列的结尾后一位置
(公开成员对象)

[编辑] 成员函数

 构造匹配对象
(公开成员函数) [编辑]
观察器
若存在则返回匹配的长度
(公开成员函数) [编辑]
转换为底层字符串类型
(公开成员函数) [编辑]
若存在则比较匹配的子序列
(公开成员函数) [编辑]
修改器
交换内容
(公开成员函数) [编辑]

[编辑] 非成员函数

(C++20 移除)(C++20 移除)(C++20 移除)(C++20 移除)(C++20 移除)(C++20)
 比较一个 sub_match 与另一 sub_match 、字符串或字符
(函数模板) [编辑]
输出匹配的字符子��列
(函数模板) [编辑]

[编辑] 示例

运行此代码
#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: '.'

[编辑] 参阅

(C++11)
 迭代给定字符串中的所有正则表达式匹配中的指定子表达式，或迭代未匹配的子字符串
(类模板) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/regex/sub_match&oldid=96640”