std::sub_match<BidirIt>::operator string_type, std::sub_match<BidirIt>::str

 

C++

Language

Standard Library Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

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)

Regex Grammar

Modified ECMAScript-262 (C++11)

 

std::sub_match

Member functions

sub_match::sub_match

sub_match::length

sub_match::strsub_match::operator string_type

sub_match::compare

Non-member functions

operator==operator!=operator<<operator<=operator>operator>=

operator<<

 

operator string_type() const;	(1)
string_type str() const;	(2)

Converts to an object of the underlying std::basic_string type.

The first version is an implicit conversion, the second one is explicit.

Parameters

(none)

Return value

Returns the matched character sequence as an object of the underlying std::basic_string type. If the matched member is false then the empty string is returned.

Complexity

Linear in the length of the underlying character sequence.

Example

Run this code

#include <iostream>
#include <regex>
#include <string>
int main()
{
  std::ssub_match sm;
  std::string s = sm;  // implicit conversion
  std::cout << s.length() << '\n';
}

Output:

​0​