Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/regex/sub match"

From cppreference.com
< cpp‎ | regex
(Moved ''member objects'' into a separate section.)
(Combined conversion functions.)
Line 53: Line 53:
 
{{dcl list h2 | Observers}}
 
{{dcl list h2 | Observers}}
 
{{dcl list mem fun | cpp/regex/sub_match/length | Returns the length of the match (if any).}}
 
{{dcl list mem fun | cpp/regex/sub_match/length | Returns the length of the match (if any).}}
{{dcl list mem fun | cpp/regex/sub_match/operator string_type | Implicit conversion to the underlying string type.}}
+
{{dcl list mem fun | cpp/regex/sub_match/str | title=str<br>operator string_type | Converts to the underlying string type.}}
{{dcl list mem fun | cpp/regex/sub_match/str | Explicit conversion to the underlying string type.}}
+
 
{{dcl list mem fun | cpp/regex/sub_match/compare | Compares matched subsequence (if any).}}
 
{{dcl list mem fun | cpp/regex/sub_match/compare | Compares matched subsequence (if any).}}
  

Revision as of 08:05, 21 October 2011

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

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