std::regex_token_iterator<BidirIt,CharT,Traits>::regex_token_iterator - cppreference.com (original) (raw)

Constructs a new regex_token_iterator:

1. Default constructor. Constructs the end-of-sequence iterator.

2-5) First, copies the list of the requested submatch out of the submatches or submatch argument into the member list stored in the iterator and constructs the member std::regex_iterator by passing a, b, re, and m to 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_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.

1. Copy constructor: performs member-wise copy (including making a copy of the member regex_iterator and 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.

[edit] Parameters

[edit] Example

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.