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

{{ddcl | header=regex | notes={{mark since c++11}} | 1=

The class template {{c|std::match_results}} holds a collection of character sequences that represent the result of a regular expression match.

This is a specialized allocator-aware container. It can only be default created or modified by passing to the {{c|std::regex_search()}} or {{c|std::regex_match()}} algorithms.

The first sub_match (index 0) contained in a match_result always represents the full match within a target sequence made by a regex, and subsequent sub_matches represent sub-expression matches corresponding in sequence to the left parenthesis delimiting the sub-expression in the regex.

{{param list begin}}

{{param list req concept | BidirIt | BidirectionalIterator}}

{{param list req concept | Alloc | Allocator}}

{{param list end}}

{{dcl list begin}}

{{dcl list header | regex}}

{{dcl list hitem | Type | Definition}}

{{dcl list item | {{tt|cmatch}} | {{c|match_results<const char*>}}}}

{{dcl list item | {{tt|wcmatch}} | {{c|match_results<const wchar_t*>}}}}

{{dcl list item | {{tt|smatch}} | {{c|match_results<std::string::const_iterator>}}}}

{{dcl list item | {{tt|wsmatch}} | {{c|match_results<std::wstring::const_iterator>}}}}

{{dcl list end}}

{{dcl list begin}}

{{dcl list hitem | Member type | Definition}}

{{dcl list item | {{tt|allocator_type}} | {{c|Allocator}}}}

{{dcl list item | {{tt|value_type}} | {{c|std::sub_match<BidirIt>}}}}

{{dcl list item | {{tt|const_reference}} | {{c|const value_type&}}}}

{{dcl list item | {{tt|reference}} | {{c|const_reference}}}}

{{dcl list item | {{tt|const_iterator}} | ''implementation defined'' (depends on the underlying container)}}

{{dcl list item | {{tt|iterator}} | {{c|const_iterator}}}}

{{dcl list item | {{tt|difference_type}} | {{c|std::iterator_traits<BidirIt>::difference_type}}}}

{{dcl list item | {{tt|size_type}} | {{c|std::allocator_traits<Alloc>::size_type}}}}

{{dcl list item | {{tt|char_type}} | {{c|std::iterator_traits<BidirIt>::value_type}}}}

{{dcl list item | {{tt|string_type}} | {{c|std::basic_string<char_type>}}}}

{{dcl list end}}

{{dcl list begin}}

{{dcl list template | cpp/regex/match_results/dcl list constructor}}

{{dcl list template | cpp/regex/match_results/dcl list destructor}}

{{dcl list template | cpp/regex/match_results/dcl list operator{{=}}}}

{{dcl list template | cpp/regex/match_results/dcl list get_allocator}}

 

{{dcl list mem fun | cpp/regex/match_results/ready | }}

{{dcl list h2 | Size}}

{{dcl list template | cpp/regex/match_results/dcl list empty}}

{{dcl list template | cpp/regex/match_results/dcl list size}}

{{dcl list template | cpp/regex/match_results/dcl list max_size}}

{{dcl list h2 | Element access}}

{{dcl list template | cpp/regex/match_results/dcl list length}}

{{dcl list template | cpp/regex/match_results/dcl list position}}

{{dcl list template | cpp/regex/match_results/dcl list str}}

{{dcl list template | cpp/regex/match_results/dcl list suffix}}

{{dcl list h2 | Iterators}}

{{dcl list template | cpp/regex/match_results/dcl list begin}}

{{dcl list template | cpp/regex/match_results/dcl list end}}

{{dcl list h2 | Format}}

{{dcl list template | cpp/regex/match_results/dcl list format}}

{{dcl list h2 | Modifiers}}

{{dcl list template | cpp/regex/match_results/dcl list swap}}

{{dcl list end}}

{{dcl list begin}}

{{dcl list template | cpp/regex/match_results/dcl list operator_cmp}}

{{dcl list template | cpp/regex/match_results/dcl list swap2}}

{{dcl list end}}

[[de:cpp/regex/match results]]

[[es:cpp/regex/match results]]

[[fr:cpp/regex/match results]]

[[it:cpp/regex/match results]]

[[ja:cpp/regex/match results]]

[[pt:cpp/regex/match results]]

[[ru:cpp/regex/match results]]

[[zh:cpp/regex/match results]]