std::match_results::position

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Regular expressions library

Classes

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Algorithms

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Iterators

regex_iterator (C++11)

regex_token_iterator (C++11)

Exceptions

regex_error (C++11)

Traits

regex_traits (C++11)

Constants

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

 

std::match_results

Member functions

match_results::match_results (C++11)

match_results::~match_results (C++11)

match_results::operator= (C++11)

match_results::get_allocator (C++11)

State

match_results::ready (C++11)

Element access

match_results::size (C++11)

match_results::max_size (C++11)

match_results::empty (C++11)

match_results::length (C++11)

match_results::position (C++11)

match_results::str (C++11)

match_results::operator_at (C++11)

match_results::prefix (C++11)

match_results::suffix (C++11)

Iterators

match_results::begin match_results::cbegin (C++11)

match_results::end match_results::cend (C++11)

Format

match_results::format (C++11)

Modifiers

match_results::swap (C++11)

 

difference_type position( size_type sub = 0 ) const;		(since C++11)

Returns the position of the first character of the specified sub-match.

If n == 0, the position of the first character of entire matched expression is returned.

If n > 0 && n < size(), the position of the first character of nth sub-match is returned.

if n >= size(), a position of the first character of the unmatched match is returned.

Parameters

n

-

integral number specifying which match to examine

Return value

The position of the first character of the specified match or sub-match.

Example

#include <iostream>
#include <regex>
#include <string>
 
int main()
{
    std::regex re("a(a)*b");
    std::string target("aaab");
    std::smatch sm;
 
    std::regex_match(target, sm, re);
    std::cout << sm.position(1) << '\n';
}

Output:

1

See also

operator[]	returns specified sub-match (public member function)