Share via


<regex>

Defines a template class to parse TR1 Regular Expressions, 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

TR1 Regular Expressions

Other Resources

<regex> Members