Difference between revisions of "cpp/regex/sub match"
(minor rewording) |
m (+seealso to regex_token_iterator, +missing op<<) |
||
| Line 60: | Line 60: | ||
{{dcl list begin}} | {{dcl list begin}} | ||
{{dcl list template | cpp/regex/dcl list operator_cmp | sub_match}} | {{dcl list template | cpp/regex/dcl list operator_cmp | sub_match}} | ||
| + | {{dcl list tfun | cpp/regex/sub_match/operator_ltlt | title=operator<< | outputs the matched character subsequence}} | ||
| + | {{dcl list end}} | ||
| + | |||
| + | ===See also=== | ||
| + | {{dcl list begin}} | ||
| + | {{dcl list tclass | cpp/regex/regex_token_iterator | iterates through regex submatches | notes={{mark c++11}}}} | ||
{{dcl list end}} | {{dcl list end}} | ||
Revision as of 10:18, 28 May 2012
Template:cpp/regex/sub match/sidebar
| Defined in header <regex>
|
||
| template< class BidirectionalIterator |
(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 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.
|-
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.
|-
Member functions
Observers |
Non-member functions
| outputs the matched character subsequence (function template) |
See also
| (C++11) |
iterates through regex submatches (class template) |
