Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | regex
m (+seealso to regex_token_iterator, +missing op<<)
m (Text replace - "{{tdcl list begin" to "{{dcl list begin")
Line 18: Line 18:
 
Several specializations for common character sequence types are provided:  
 
Several specializations for common character sequence types are provided:  
  
−
{{tdcl list begin}}
+
{{dcl list begin}}
 
{{tdcl list header | regex}}
 
{{tdcl list header | regex}}
 
{{tdcl list hitem | Type | Definition}}
 
{{tdcl list hitem | Type | Definition}}
Line 28: Line 28:
  
 
===Member types===
 
===Member types===
−
{{tdcl list begin}}
+
{{dcl list begin}}
 
{{tdcl list hitem | Member type | Definition}}
 
{{tdcl list hitem | Member type | Definition}}
 
{{tdcl list item | {{tt|iterator}} | {{c|BidirectionalIterator}}}}
 
{{tdcl list item | {{tt|iterator}} | {{c|BidirectionalIterator}}}}
Line 37: Line 37:
  
 
===Member objects===
 
===Member objects===
−
{{tdcl list begin}}
+
{{dcl list begin}}
 
{{dcl list item| {{tt|matched}} | Indicates if this match was successful.}}
 
{{dcl list item| {{tt|matched}} | Indicates if this match was successful.}}
 
{{tdcl list end}}
 
{{tdcl list end}}
 
{{inherited | [[cpp/utility/pair | {{small|std::}}pair]] |
 
{{inherited | [[cpp/utility/pair | {{small|std::}}pair]] |
−
{{tdcl list begin}}
+
{{dcl list begin}}
 
{{dcl list item| {{tt|first}} | Start of the match sequence.}}
 
{{dcl list item| {{tt|first}} | Start of the match sequence.}}
 
{{dcl list item| {{tt|second}} | One-past-the-end of the match sequence.}}
 
{{dcl list item| {{tt|second}} | One-past-the-end of the match sequence.}}

Revision as of 01:22, 12 June 2012

Template:cpp/regex/sub match/sidebar

Defined in header <regex>
template<

    class BidirectionalIterator

> class sub_match;
 (since C++11)

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. Instances of sub_match are normally constructed and populated as a part of a std::match_results container during the processing of one of the regex algorithms.

The member functions return defined default values unless the matched member is true.

sub_match inherits from std::pair<BidirectionalIterator, BidirectionalIterator>, although it cannot be treated as a std::pair 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 headerTemplate:tdcl list hitemTemplate:tdcl list itemTemplate:tdcl list itemTemplate:tdcl list itemTemplate:tdcl list itemTemplate:tdcl list end

Contents

Member types

Template:tdcl list hitemTemplate:tdcl list itemTemplate:tdcl list itemTemplate:tdcl list itemTemplate:tdcl list itemTemplate:tdcl list end

Member objects

Template:tdcl list end

Inherited from std::pair

matched Indicates if this match was successful.
Template:tdcl list end

Member functions

first Start of the match sequence.
second One-past-the-end of the match sequence.
Template:cpp/regex/sub match/dcl list constructorTemplate:cpp/regex/sub match/dcl list lengthTemplate:cpp/regex/sub match/dcl list strTemplate:cpp/regex/sub match/dcl list compare
Observers

Non-member functions

Template:cpp/regex/dcl list operator cmp
 outputs the matched character subsequence
(function template)

See also

(C++11)
 iterates through regex submatches
(class template)
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/regex/sub_match&oldid=32032"