public member function
<regex>

std::regex_token_iterator::operator*

const value_type& operator*() const;
Dereference regex_token_iterator
Returns a reference to the sub_match subsequence the iterator is pointing to.

This operator shall not be applied to end-of-sequence iterators (the behavior of such an operation is undefined).

regex_token_iterator objects keep a regex_iterator object internally. A reference to one of its sub_match elements is returned by a call to this function. But, the state of this internal regex_iterator object that contains the submatch may be modified by a call to either operator++ or operator= on the regex_token_iterator object, which can invalidate the returned reference.

Parameters

none.

Return value

A reference to the sub_match subsequence pointed by the regex_iterator.
value_type is a member type defined as the instantiation of sub_match corresponding to the class template parameters.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// regex_token_iterator example
#include <iostream>
#include <string>
#include <regex>

int main ()
{
  std::string s ("this subject has a submarine as a subsequence");
  std::regex e ("\\b(sub)([^ ]*)");   // matches words beginning by "sub"

  std::regex_token_iterator<std::string::iterator> rend; // end-of-sequence iterator

  // iterate over second submatches of each match:
  std::regex_token_iterator<std::string::iterator> rit ( s.begin(), s.end(), e, 2 );

  while (rit!=rend) {
    std::cout << *rit << std::endl;
    ++rit;
  }

  return 0;
}


Output:
ject
marine
sequence

See also