std::regex_token_iterator<BidirIt,CharT,Traits>::regex_token_iterator

 

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::regex_token_iterator

成员函数

regex_token_iterator::regex_token_iterator

regex_token_iterator::operator=

比较

regex_token_iterator::operator==regex_token_iterator::operator!= (C++20 前)

观察器

regex_token_iterator::operator*regex_token_iterator::operator->

修改器

regex_token_iterator::operator++regex_token_iterator::operator++(int)

 

<tbody> </tbody>

regex_token_iterator();	(1)	(C++11 起)
regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, int submatch = 0, std::regex_constants::match_flag_type m = std::regex_constants::match_default );	(2)	(C++11 起)
regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, const std::vector<int>& submatches, std::regex_constants::match_flag_type m = std::regex_constants::match_default );	(3)	(C++11 起)
regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, std::initializer_list<int> submatches, std::regex_constants::match_flag_type m = std::regex_constants::match_default );	(4)	(C++11 起)
template< std::size_t N > regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, const int (&submatches)[N], std::regex_constants::match_flag_type m = std::regex_constants::match_default );	(5)	(C++11 起)
regex_token_iterator( const regex_token_iterator& other );	(6)	(C++11 起)
regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, int submatch = 0, std::regex_constants::match_flag_type m = std::regex_constants::match_default ) = delete;	(7)	(C++11 起)
regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, const std::vector<int>& submatches, std::regex_constants::match_flag_type m = std::regex_constants::match_default ) = delete;	(8)	(C++11 起)
regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, std::initializer_list<int> submatches, std::regex_constants::match_flag_type m = std::regex_constants::match_default ) = delete;	(9)	(C++11 起)
template< std::size_t N > regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, const int (&submatches)[N], std::regex_constants::match_flag_type m = std::regex_constants::match_default ) = delete;	(10)	(C++11 起)

See More

构造新的 regex_token_iterator：

1) 默认构造函数。构造序列尾迭代器。

2-5) 首先，将 submatches 或 submatch 实参的请求的子匹配列表，复制到存储于迭代器的成员列表中，再通过传递 a、b、re 和 m 到其四参数构造函数（该构造函数进行对 std::regex_search 的初始调用）构造成员 std::regex_iterator，然后设置 submatches 的内部计数器为零。

• 若构造后，成员 regex_iterator 不是序列尾迭代器，则设置成员指针为当前 std::sub_match 的地址。
• 否则（若成员 regex_iterator 是序列尾迭代器），但值 -1 是 submatches/submatch 中的值之一，则将 *this 转变为指向范围 [a, b) 的后缀迭代器（整个字符串是非匹配的后缀）。
• 否则，（若 -1 不在子匹配列表中），将 *this 转变为序列尾迭代器。

若 submatches 中任何值小于 -1 则行为未定义。

6) 复制构造函数：进行逐元素复制（包含对成员 regex_iterator 和指向 sub_match 的成员指针的复制）。

7-10) 禁止以临时 regex 调用重载 (2-5) ，因为否则返回的迭代器会被立即非法化。

参数

a	-	指向目标字符序列起始的老式双向迭代器 (LegacyBidirectionalIterator)
b	-	指向目标字符序列末尾的老式双向迭代器 (LegacyBidirectionalIterator)
re	-	用于在目标字符序列中搜索的正则表达式
submatch	-	应当返回的子匹配的索引。"0" 表示整体匹配，而 "-1" 表示未匹配的部分（例如匹配间的部分）
submatches	-	应当在每个匹配内迭代的子匹配的索引的序列，可能包含代表非匹配片段的特殊值 -1
m	-	掌管 re 行为的标志

参阅

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 2332	C++11	从临时 basic_regex 构造的 regex_token_iterator 立即变为非法	通过被删除的重载禁止这种构造