std::regex_iterator
定义于头文件 <regex>
|
||
template< class BidirIt, |
(C++11 起) | |
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> )。
类型要求
-BidirIt 必须满足遗留双向迭代器 (LegacyBidirectionalIterator) 的要求。
|
特化
提供对于常用字符序列类型的数个特化:
定义于头文件
<regex> | |
类型 | 定义 |
cregex_iterator
|
regex_iterator<const char*> |
wcregex_iterator
|
regex_iterator<const wchar_t*> |
sregex_iterator
|
regex_iterator<std::string::const_iterator> |
wsregex_iterator
|
regex_iterator<std::wstring::const_iterator> |
成员类型
成员类型 | 定义 |
value_type
|
std::match_results<BidirIt> |
difference_type
|
std::ptrdiff_t |
pointer
|
const value_type* |
reference
|
const value_type& |
iterator_category
|
std::forward_iterator_tag |
regex_type
|
basic_regex<CharT, Traits> |
成员函数
构造新的 regex_iterator (公开成员函数) | |
(析构函数) (隐式声明) |
析构 regex_iterator ,包含缓存的值 (公开成员函数) |
赋值内容 (公开成员函数) | |
(C++20 中移除) |
比较两个 regex_iterator (公开成员函数) |
访问当前匹配 (公开成员函数) | |
推进迭代器到下一个匹配 (公开成员函数) |
注解
程序员负责确保传递给迭代器构造函数的 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.
参阅
(C++11) |
标识一个正则表达式匹配,包含所有子表达式匹配 (类模板) |
(C++11) |
尝试匹配一个正则表达式到字符序列的任何部分 (函数模板) |