28 Text processing library [text]

28.6 Regular expressions library [re]

28.6.11 Regular expression iterators [re.iter]

28.6.11.2 Class template regex_token_iterator [re.tokiter]

28.6.11.2.2 Constructors [re.tokiter.cnstr]

regex_token_iterator();

Effects: Constructs the end-of-sequence iterator.

🔗

regex_token_iterator(BidirectionalIterator a, BidirectionalIterator b,
                     const regex_type& re,
                     int submatch = 0,
                     regex_constants::match_flag_type m = regex_constants::match_default);

regex_token_iterator(BidirectionalIterator a, BidirectionalIterator b,
                     const regex_type& re,
                     const vector<int>& submatches,
                     regex_constants::match_flag_type m = regex_constants::match_default);

regex_token_iterator(BidirectionalIterator a, BidirectionalIterator b,
                     const regex_type& re,
                     initializer_list<int> submatches,
                     regex_constants::match_flag_type m = regex_constants::match_default);

template<size_t N>
  regex_token_iterator(BidirectionalIterator a, BidirectionalIterator b,
                       const regex_type& re,
                       const int (&submatches)[N],
                       regex_constants::match_flag_type m = regex_constants::match_default);

Preconditions: Each of the initialization values of submatches is >= -1.

Effects: The first constructor initializes the member subs to hold the single value submatch.

The second, third, and fourth constructors initialize the member subs to hold a copy of the sequence of integer values pointed to by the iterator range [begin(submatches), end(submatches)).

Each constructor then sets N to 0, and position to position_iterator(a, b, re, m).

If position is not an end-of-sequence iterator the constructor sets result to the address of the current match.

Otherwise if any of the values stored in subs is equal to

- 1

the constructor sets *this to a suffix iterator that points to the range [a, b), otherwise the constructor sets *this to an end-of-sequence iterator.