<regex>

Defines a template class to parse Regular Expressions (C++), and several template classes and functions to search text for matches to a regular expression object.

#include <regex>

Remarks

To create a regular expression object, use the template class basic_regex Class or one of its specializations, regex Typedef and wregex Typedef, together with the syntax flags of type regex_constants::syntax_option_type.

To search text for matches to a regular expression object, use the template functions regex_match Function and regex_search Function, together with the match flags of type regex_constants::match_flag_type. These functions return results by using the template class match_results Class and its specializations, cmatch Typedef, wcmatch Typedef, smatch Typedef, and wsmatch Typedef, together with the template class sub_match Class and its specializations, csub_match Typedef, wcsub_match Typedef, ssub_match Typedef, and wssub_match Typedef.

To replace text that matches a regular expression object, use the template function regex_replace Function, together with the match flags of type regex_constants::match_flag_type.

To iterate through multiple matches of a regular expression object, use the template classes regex_iterator Class and regex_token_iterator Class or one of their specializations, cregex_iterator Typedef, sregex_iterator Typedef, wcregex_iterator Typedef, wsregex_iterator Typedef, cregex_token_iterator Typedef, sregex_token_iterator Typedef, wcregex_token_iterator Typedef, or wsregex_token_iterator Typedef, together with the match flags of type regex_constants::match_flag_type.

To modify the details of the grammar of regular expressions, write a class that implements the regular expression traits.

Classes

basic_regex	Wraps a regular expression.
match_results	Holds a sequence of submatches.
regex_constants	Holds assorted constants.
regex_error	Reports a bad regular expression.
regex_iterator	Iterates through match results.
regex_traits	Describes characteristics of elements for matching.
regex_traits<char>	Describes characteristics of char for matching.
regex_traits<wchar_t>	Describes characteristics of wchar_t for matching.
regex_token_iterator	Iterates through submatches.
sub_match	Describes a submatch.

Type Definitions

cmatch	Type definition for charmatch_results.
cregex_iterator	Type definition for charregex_iterator.
cregex_token_iterator	Type definition for charregex_token_iterator.
csub_match	Type definition for charsub_match.
regex	Type definition for charbasic_regex.
smatch	Type definition for stringmatch_results.
sregex_iterator	Type definition for stringregex_iterator.
sregex_token_iterator	Type definition for stringregex_token_iterator.
ssub_match	Type definition for stringsub_match.
wcmatch	Type definition for wchar_tmatch_results.
wcregex_iterator	Type definition for wchar_tregex_iterator.
wcregex_token_iterator	Type definition for wchar_tregex_token_iterator.
wcsub_match	Type definition for wchar_tsub_match.
wregex	Type definition for wchar_tbasic_regex.
wsmatch	Type definition for wstringmatch_results.
wsregex_iterator	Type definition for wstringregex_iterator.
wsregex_token_iterator	Type definition for wstringregex_token_iterator.
wssub_match	Type definition for wstringsub_match.

Functions

regex_match	Exactly matches a regular expression.
regex_replace	Replaces matched regular expressions.
regex_search	Searches for a regular expression match.
swap	Swaps basic_regex or match_results objects.

Operators

operator==	Comparison of various objects, equal.
operator!=	Comparison of various objects, not equal.
operator<	Comparison of various objects, less than.
operator<=	Comparison of various objects, less than or equal.
operator>	Comparison of various objects, greater than.
operator>=	Comparison of various objects, greater than or equal.
operator<<	Inserts a sub_match in a stream.

See Also

Concepts

Regular Expressions (C++)