std::sub_match

Defined in header <regex>
template<     class BidirectionalIterator > class sub_match;		Template:mark c++11 feature

The class template sub_match is used by the regular expression engine to denote sequences of characters matched by marked sub-expressions. A match is a [begin, end) pair within the target range matched by the regular expression, but with additional observer functions to enhance code clarity.

Only the default constructor is publicly accessible: object of this class are normally constructed and populated as a part of a Template:cpp container during the processing of one of the regex algorithms.

The member functions return defined default values unless the Template:cpp member is true.

Inherits Template:cpp, although this type can not be treated as a Template:cpp object because member functions such as swap and assignment will not work as expected.

Several specializations for common character sequence types are provided:

Member objects

Template:tdcl list begin |- class="t-dsc" | matched | Indicates if this match was successful. |-

Inherited from Template:cpp

Template:tdcl list begin |- class="t-dsc" | first | Start of the match sequence. |-

|- class="t-dsc" | second | One-past-the-end of the match sequence. |-

Member functions

(constructor)	constructs the match object (public member function)
Observers
length	Returns the length of the match (if any). (public member function)
operator string_type	Implicit conversion to the underlying string type. (public member function)
str	Explicit conversion to the underlying string type. (public member function)
compare	Compares matched subsequence (if any). (public member function)

Non-member functions

Template:cpp/regex/dcl list operator comp