public member function
<regex>

std::match_results::cbegin

const_iterator cbegin() const;
Return const_iterator to beginning
Returns a const_iterator pointing to the first match in the match_results object. Together with match_results::cend, these functions describe a range that encompasses all the matches in the match_results object.

In match_results, where the matches contained are always const, this function is exactly the same as match_results::begin.

Parameters

none

Return value

An iterator to to the sub_match object describing the first match in the match_results object.

Member type const_iterator (the same as member type iterator) is a forward iterator type.
The matches contained in a match_results object are always const.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// match_results::cbegin/cend
// - using smatch, a standard alias of match_results<string::iterator>
#include <iostream>
#include <string>
#include <regex>

int main ()
{
  std::string s ("subject");
  std::smatch m;
  std::regex e ("(sub)(.*)");

  std::regex_match ( s, m, e );

  std::cout << "matches:" << std::endl;
  for (std::smatch::iterator it = m.cbegin(); it!=m.cend(); ++it) {
	std::cout << *it << std::endl;
  }
  return 0;
}

Output:
matches:
subject
sub
ject



See also