regex_token_iterator( const regex_token_iterator& other );
Constructs a new
1) Default constructor. Constructs the end-of-sequence iterator.
2-5) First, copies the list of the requested submatch out of the
submatchargument into the member list stored in the iterator and constructs the member std::regex_iterator by passing
mto its four-argument constructor (that constructor performs the initial call to std::regex_search) and sets the internal counter of submatches to zero.
- If, after construction, the member
regex_iteratoris not an end-of-sequence iterator, sets the member pointer to the address of the current std::sub_match.
- Otherwise (if the member
regex_iteratoris an end-of-sequence iterator), but the value -1 is one of the values in
*thisinto 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
*thisinto the end-of-sequence iterator.
The behavior is undefined if any value in
submatches is less than -1.
6) Copy constructor: performs member-wise copy (including making a copy of the member
regex_iteratorand the member pointer to current sub_match).
7-10) The overloads (2-5) are prohibited from being called with a temporary regex since otherwise the returned iterator would be immediately invalidated
|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 |
|This section is incomplete|
Reason: no example
 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
|such construction is disallowed via deleted overloads|