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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

正则表达式库

类

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_iterator

成员函数

regex_iterator::regex_iterator

regex_iterator::operator=

比较

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

观察器

regex_iterator::operator*regex_iterator::operator->

修改器

regex_iterator::operator++regex_iterator::operator++(int)

 

regex_iterator();	(1)	(C++11 起)
regex_iterator( BidirIt a, BidirIt b,                 const regex_type& re,                 std::regex_constants::match_flag_type m =                     std::regex_constants::match_default );	(2)	(C++11 起)
regex_iterator( const regex_iterator& );	(3)	(C++11 起)
regex_iterator( BidirIt, BidirIt,                 const regex_type&&,                 std::regex_constants::match_flag_type =                     std::regex_constants::match_default ) = delete;	(4)	(C++11 起)

构造新的 regex_iterator：

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

2) 从字符序列 [a, b)、正则表达式 re 和掌管匹配行为的标志 m 构造 regex_iterator。此构造函数以此数据进行 std::regex_search 的初始调用。若此初始调用结构为 false，则设置 *this 为序列尾迭代器。

3) 复制 regex_iterator。

4) 不允许以正则表达式临时量调用重载 2，因为返回的迭代器会立即失效。

参数

a	-	指向目标字符序列起始的老式双向迭代器 (LegacyBidirectionalIterator)
b	-	指向目标字符序列末尾的老式双向迭代器 (LegacyBidirectionalIterator)
re	-	用于搜索目标字符序列的正则表达式
m	-	掌管 re 行为的标志

示例

运行此代码

#include <iostream>
#include <regex>
#include <string_view>
 
int main()
{
    constexpr std::string_view str{R"(
        #ONE: *p = &Mass;
        #Two: MOV %rd, 42
    )"};
    const std::regex re("[a-w]");
 
    // 创建 regex_iterator，重载 (2)
    auto it = std::regex_iterator<std::string_view::iterator>
    {
        str.cbegin(), str.cend(),
        re // re 是左值；如果改用立即表达式，如 std::regex{"[a-z]"}
           // 则会由于重载 (4) 被弃置而产生错误
    };
 
    for (decltype(it) last /* overload (1) */; it != last; ++it)
        std::cout << (*it).str();
    std::cout << '\n';
}

输出：

password

缺陷报告

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

缺陷报告	应用于	出版时的行为	正确行为
LWG 2332	C++11	从临时 basic_regex 构造的 regex_iterator 会立即失效	通过被弃置的重载禁止这种构造