public member function
<regex>

std::regex_iterator::operator->

const value_type* operator->() const;
Dereference regex_iterator
Returns a pointer to the match_results object the iterator is pointing to.

The pointer is generally used to access a member of that object directly using the built-in operator-> syntax.

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

regex_iterator objects keep a match_results object internally. A pointer to this object is returned by a call to this function. The value of the pointed object may be modified by a call to either operator++ or operator= on the regex_iterator object.

Parameters

none.

Return value

A pointer to the match_results object selected by the regex_iterator.
value_type is a member type defined as the instantiation of match_results 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
// regex_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_iterator<std::string::iterator> rit ( s.begin(), s.end(), e );
  std::regex_iterator<std::string::iterator> rend;

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

  return 0;
}


Output:
subject
submarine
subsequence


See also