Namespaces
Variants
Views
Actions

std::sub_match

From cppreference.com
< cpp‎ | regex
Revision as of 09:36, 27 October 2011 by P12 (Talk | contribs)

Template:cpp/regex/sub match/sidebar

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:

Template:tdcl list begin Template:tdcl list header Template:tdcl list hitem Template:tdcl list item Template:tdcl list item Template:tdcl list item Template:tdcl list item Template:tdcl list end

Contents

Member types

Template:tdcl list begin Template:tdcl list hitem Template:tdcl list item Template:tdcl list item Template:tdcl list item Template:tdcl list item Template:tdcl list end

Member objects

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

Template:tdcl list end

Inherited from std::pair

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. |-

Template:tdcl list end

Member functions

constructs the match object
(public member function)
Observers
Returns the length of the match (if any).
(public member function)
Converts to the underlying string type.
(public member function)
Compares matched subsequence (if any).
(public member function)

Non-member functions

Template:cpp/regex/dcl list operator comp