std::regex_iterator

std::regex_iterator 是访问底层字符序列中正则表达式的单独匹配的只读遗留向前迭代器 (LegacyForwardIterator) 。

在构造和每次自增时，它调用 std::regex_search 并记忆结果（即保存值 std::match_results<BidirIt> 的副本）。第一个对象可能在构造迭代器或进行首次解引用时读取。其他情况下，解引用只返回最近获得的正则表达式匹配副本。

默认构造的 std::regex_iterator 是序列尾迭代器。在抵达最后匹配（std::regex_search 返回 false ）后自增合法的 std::regex_iterator 时，它变得等于序列尾迭代器。进一步解引用或自增它引发未定义行为。

典型的 std::regex_iterator 实现保有底层序列的开始和结束迭代器（二个 BidirIt 实例）、指向正则表达式的指针（ const regex_type* ）、匹配标志（ std::regex_constants::match_flag_type ）和当前匹配（ std::match_results<BidirIt> ）。

类型要求

特化

提供对于常用字符序列类型的数个特化：

成员类型

成员函数

注解

程序员负责确保传递给迭代器构造函数的 std::basic_regex 对象活得长于迭代器。因为迭代器存储指向 regex 的指针，故在销毁 regex 后自增迭代器会访问悬垂指针。

若匹配的正则表达式部分仅是断言（ ^ 、 $ 、 \b 、 \B ），则存储于迭代器的匹配是零长度匹配，即 match[0].first == match[0].second 。

示例

#include <regex>
#include <iterator>
#include <iostream>
#include <string>
 
int main()
{
    const std::string s = "Quick brown fox.";
 
    std::regex words_regex("[^\\s]+");
    auto words_begin = 
        std::sregex_iterator(s.begin(), s.end(), words_regex);
    auto words_end = std::sregex_iterator();
 
    std::cout << "Found " 
              << std::distance(words_begin, words_end) 
              << " words:\n";
 
    for (std::sregex_iterator i = words_begin; i != words_end; ++i) {
        std::smatch match = *i;                                                 
        std::string match_str = match.str(); 
        std::cout << match_str << '\n';
    }   
}

Found 3 words:
Quick
brown
fox.

参阅