std::regex_token_iterator<BidirIt,CharT,Traits>::regex_token_iterator
regex_token_iterator(); |
(1) | (since C++11) |
regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, |
(2) | (since C++11) |
regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, |
(3) | (since C++11) |
regex_token_iterator( BidirIt a, BidirIt b, const regex_type& re, |
(4) | (since C++11) |
template< std::size_t N > regex_token_iterator( BidirIt a, BidirIt b, |
(5) | (since C++11) |
regex_token_iterator( const regex_token_iterator& other ); |
(6) | (since C++11) |
regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, |
(7) | (since C++11) |
regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, |
(8) | (since C++11) |
regex_token_iterator( BidirIt a, BidirIt b, const regex_type&& re, |
(9) | (since C++11) |
template< std::size_t N > regex_token_iterator( BidirIt a, BidirIt b, |
(10) | (since C++11) |
Constructs a new regex_token_iterator
:
- If, after construction, the member
regex_iterator
is not an end-of-sequence iterator, sets the member pointer to the address of the current std::sub_match. - Otherwise (if the member
regex_iterator
is an end-of-sequence iterator), but the value -1 is one of the values in submatches/submatch, turns *this into a suffix iterator pointing at the range[
a,
b)
(the entire string is the non-matched suffix). - Otherwise (if -1 is not in the list of submatches), turns *this into the end-of-sequence iterator.
The behavior is undefined if any value in submatches is less than -1.
regex_iterator
and the member pointer to current sub_match).[edit] Parameters
a | - | LegacyBidirectionalIterator to the beginning of the target character sequence |
b | - | LegacyBidirectionalIterator to the end of the target character sequence |
re | - | regular expression used to search the target character sequence |
submatch | - | the index of the submatch that should be returned. "0" represents the entire match, and "-1" represents the parts that are not matched (e.g, the stuff between matches) |
submatches | - | the sequence of submatch indices that should be iterated over within each match, may include the special value -1 for the non-matched fragments |
m | - | flags that govern the behavior of re |
[edit] Example
This section is incomplete Reason: no example |
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 2332 | C++11 | a regex_token_iterator constructed from atemporary basic_regex became invalid immediately
|
such construction is disallowed via deleted overloads |