<regex>

更新 : 2007 年 11 月

TR1 の正規表現を解析するためのテンプレート クラスと、テキストから正規表現オブジェクトとの一致を検索するためのテンプレート クラスおよび関数を定義します。

#include <regex>

宣言

クラス

説明

basic_regex クラス

正規表現をラップします。

match_results クラス

一連のサブマッチを保持します。

regex_constants クラス

各種の定数を保持します。

regex_error クラス

無効な正規表現を報告します。

regex_iterator クラス

一致した結果を反復処理します。

regex_traits クラス

検索する要素の特性を表します。

regex_traits<char> クラス

char の一致に対する特性を表します。

regex_traits<wchar_t> クラス

wchar_t の一致に対する特性を表します。

regex_token_iterator クラス

サブマッチを反復処理します。

sub_match クラス

サブマッチを表します。

型定義

説明

cmatch Typedef

charmatch_results の型定義です。

cregex_iterator Typedef

charregex_iterator の型定義です。

cregex_token_iterator Typedef

charregex_token_iterator の型定義です。

csub_match Typedef

charsub_match の型定義です。

regex Typedef

charbasic_regex の型定義です。

smatch Typedef

stringmatch_results の型定義です。

sregex_iterator Typedef

stringregex_iterator の型定義です。

sregex_token_iterator Typedef

stringregex_token_iterator の型定義です。

ssub_match Typedef

stringsub_match の型定義です。

wcmatch Typedef

wchar_tmatch_results の型定義です。

wcregex_iterator Typedef

wchar_tregex_iterator の型定義です。

wcregex_token_iterator Typedef

wchar_tregex_token_iterator の型定義です。

wcsub_match Typedef

wchar_tsub_match の型定義です。

wregex Typedef

wchar_tbasic_regex の型定義です。

wsmatch Typedef

wstringmatch_results の型定義です。

wsregex_iterator Typedef

wstringregex_iterator の型定義です。

wsregex_token_iterator Typedef

wstringregex_token_iterator の型定義です。

wssub_match Typedef

wstringsub_match の型定義です。

テンプレート関数

関数

説明

regex_match 関数

正規表現と完全に一致しているかどうかを調べます。

regex_replace 関数

一致した正規表現を置換します。

regex_search 関数

正規表現の一致を検索します。

swap 関数 <regex>

basic_regex オブジェクトまたは match_results オブジェクトを交換します。

演算子

説明

operator== <regex>

各種オブジェクトの大小関係 (等しい) を比較します。

operator!= <regex>

各種オブジェクトの大小関係 (等しくない) を比較します。

operator< <regex>

各種オブジェクトの大小関係 (より小さい) を比較します。

operator<= <regex>

各種オブジェクトの大小関係 (以下) を比較します。

operator> <regex>

各種オブジェクトの大小関係 (より大きい) を比較します。

operator>= <regex>

各種オブジェクトの大小関係 (以上) を比較します。

operator<< <regex>

sub_match をストリームに挿入します。

解説

正規表現オブジェクトを作成するには、テンプレート クラス basic_regex クラス またはこのクラスから特化したクラス (regex Typedef および wregex Typedef) のいずれかを、regex_constants::syntax_option_type 型の構文フラグと組み合わせて使用します。

テキストから正規表現オブジェクトとの一致を検索するには、テンプレート関数 regex_match 関数 および regex_search 関数 を、regex_constants::match_flag_type 型の一致フラグと組み合わせて使用します。これらの関数は、テンプレート クラス match_results クラス とこのクラスから特化したクラス (cmatch Typedefwcmatch Typedefsmatch Typedef、および wsmatch Typedef) を、テンプレート クラス sub_match クラス とこのクラスから特化したクラス (csub_match Typedefwcsub_match Typedefssub_match Typedef、および wssub_match Typedef) と組み合わせて使用することにより結果を返します。

正規表現オブジェクトと一致するテキストを置換するには、テンプレート関数 regex_replace 関数 を、regex_constants::match_flag_type 型の一致フラグと組み合わせて使用します。

正規表現オブジェクトに対する複数の一致を反復処理するには、テンプレート クラス regex_iterator クラス および regex_token_iterator クラス、またはこれらのクラスから特化したクラス (cregex_iterator Typedefsregex_iterator Typedefwcregex_iterator Typedefwsregex_iterator Typedefcregex_token_iterator Typedefsregex_token_iterator Typedefwcregex_token_iterator Typedef、または wsregex_token_iterator Typedef) を、regex_constants::match_flag_type 型の一致フラグと組み合わせて使用します。

正規表現の文法をカスタマイズするには、正規表現の特徴 (traits) を実装するクラスを作成します。

参照

概念

TR1 の正規表現