std::regex_token_iterator 是访问底层字符序列内每个正则表达式匹配的单独子匹配的只读遗留向前迭代器 (LegacyForwardIterator) 。它亦可用于访问不为给定的正则表达式所匹配的序列部分（例如作为记号化器）。

构造时，它构造一个 std::regex_iterator ，而在每次自增时，它走过请求的来自当前 match_results 的子匹配，并在自增离开上个子匹配时自增底层的 regex_iterator 。

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

在恰好变为序列尾迭代器前，若请求的子匹配下标列表中出现 -1 （非匹配碎片），则 std::regex_token_iterator 可成为后缀迭代器。若解引用这种迭代器，则返回对应最后匹配和序列结尾之间的字符序列的 match_results 。

std::regex_token_iterator 的典型实现保有底层的 std::regex_iterator 、请求的子匹配下标的容器（例如 std::vector<int> ）、等于子匹配下标的内部计数器、指向当前匹配的当前子匹配的指向 std::sub_match 指针和含有最近非匹配字符序列的 std::match_results 对象（用于记号化器模式）。

类型要求

特化

定义对常用字符序列类型的数个特化：

成员类型

成员函数

注意

程序员负责确保传递给迭代器构造函数的 std::basic_regex 对象活得久于迭代器。因为迭代器存储 std::regex_iterator ，它存储指向 regex 的指针，故在销毁 regex 后自增迭代器导致未定义行为。

示例

#include <fstream>
#include <iostream>
#include <algorithm>
#include <iterator>
#include <regex>
 
int main()
{
   std::string text = "Quick brown fox.";
   // 记号化（非匹配碎片）
   // 注意仅匹配二次 regex ：在获得第三值时迭代器为后缀迭代器。
   std::regex ws_re("\\s+"); // 空白符
   std::copy( std::sregex_token_iterator(text.begin(), text.end(), ws_re, -1),
              std::sregex_token_iterator(),
              std::ostream_iterator<std::string>(std::cout, "\n"));
 
   // 迭代首个子匹配
   std::string html = "<p><a href=\"http://google.com\">google</a> "
                      "< a HREF =\"http://cppreference.com\">cppreference</a>\n</p>";
   std::regex url_re("<\\s*A\\s+[^>]*href\\s*=\\s*\"([^\"]*)\"", std::regex::icase);
   std::copy( std::sregex_token_iterator(html.begin(), html.end(), url_re, 1),
              std::sregex_token_iterator(),
              std::ostream_iterator<std::string>(std::cout, "\n"));
}

Quick
brown
fox.
http://google.com
http://cppreference.com