std::regex_constants::syntax_option_type

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

テキスト処理ライブラリ

ローカライズライブラリ

正規表現ライブラリ (C++11)

フォーマットライブラリ (C++20)

ヌル終端シーケンスユーティリティ

バイト文字列

マルチバイト文字列

ワイド文字列

プリミティブな数値変換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

テキストエンコーディング識別

text_encoding (C++26)

 

正規表現ライブラリ

クラス

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

アルゴリズム

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

イテレータ

regex_iterator (C++11)

regex_token_iterator (C++11)

例外

regex_error (C++11)

Traits

regex_traits (C++11)

定数

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

正規表現文法

修正ECMAScript-262 (C++11)

 

ヘッダ <regex> で定義
using syntax_option_type = /* 実装定義 */;	(1)	(C++11以降)
constexpr syntax_option_type icase      = /* 未指定 */; constexpr syntax_option_type nosubs     = /* 未指定 */; constexpr syntax_option_type optimize   = /* 未指定 */; constexpr syntax_option_type collate    = /* 未指定 */; constexpr syntax_option_type ECMAScript = /* 未指定 */; constexpr syntax_option_type basic      = /* 未指定 */; constexpr syntax_option_type extended   = /* 未指定 */; constexpr syntax_option_type awk        = /* 未指定 */; constexpr syntax_option_type grep       = /* 未指定 */; constexpr syntax_option_type egrep      = /* 未指定 */;	(2)	(C++11以降) (C++17以降インライン化)
inline constexpr syntax_option_type multiline = /* 未指定 */;	(3)	(C++17以降)

1) syntax_option_type は、正規表現の動作を制御するオプションを含む、ビットマスク型です。

2,3) 型 (1) の可能な値（icase、optimize など）は、std::basic_regex 内にも重複して定義されています。

定数

文法オプション	効果
ECMAScript	修正ECMAScript正規表現文法を使用する。
basic	基本POSIX正規表現文法を使用する (文法のドキュメント)。
extended	拡張POSIX正規表現文法を使用する (文法のドキュメント)。
awk	POSIXのawkユーティリティで使用される正規表現文法を使用する (文法のドキュメント)。
grep	POSIXのgrepユーティリティで使用される正規表現文法を使用する。これは事実上、basicオプションに加えて、選択(alternation)の区切り文字として改行 '\n' を追加したものと同じである。
egrep	POSIXのgrepユーティリティで-Eオプションを付けた場合に使用される正規表現文法を使用する。これは事実上、extendedオプションに加えて、選択(alternation)の区切り文字として '|' に加えて改行 '\n' を追加したものと同じである。
文法のバリエーション	効果
icase	文字のマッチングを大文字小文字を区別せずに行う。
nosubs	マッチを実行する際、マークされたすべてのサブ式 (expr) は、マークなしのサブ式 (?:expr) として扱われます。指定された std::regex_match 構造体にマッチは格納されず、mark_count() はゼロになります。
optimize	正規表現エンジンに対し、構築が遅くなる可能性を犠牲にしてマッチングを高速化するよう指示する。例えば、これは非決定性FSAを決定性FSAに変換することを意味する場合がある。
collate	"[a-b]" 形式の文字範囲はロケールに依存するようになる。
multiline (C++17)	ECMAScriptエンジンが選択されている場合、^が行の先頭にマッチし、$が行の末尾にマッチするように指定する。

ECMAScript、basic、extended、awk、grep、egrep の文法オプションからは、最大で1つだけ選択できます。文法が選択されない場合、ECMAScript が選択されたとみなされます。その他のオプションはバリエーションとして機能し、たとえば std::regex("meow", std::regex::icase) は std::regex("meow", std::regex::ECMAScript|std::regex::icase) と同等です。

注記

POSIX は「最左最長」マッチングルール（最も長いマッチする部分文字列がマッチし、そのような部分文字列が複数ある場合は最初に現れるものがマッチする）を使用するため、マークアップ言語の解析には適していません。たとえば、POSIX の正規表現 "<tag[^>]*>.*</tag>" は、最初の "<tag" から最後の "</tag>" まで、その間のすべての "</tag>" や "<tag>" を含めてマッチしてしまいます。一方、ECMAScript は非欲張りマッチをサポートしており、ECMAScript の正規表現 "<tag[^>]*>.*?</tag>" は、最初の閉じタグまでしかマッチしません。

例

ECMAScript と POSIX 正規表現のマッチングアルゴリズムの違いを示しています。

このコードを実行

#include <iostream>
#include <regex>
#include <string>
 
int main()
{
    std::string str = "zzxayyzz";
    std::regex re1(".*(a|xayy)"); // ECMA
    std::regex re2(".*(a|xayy)", std::regex::extended); // POSIX
 
    std::cout << "Searching for .*(a|xayy) in zzxayyzz:\n";
    std::smatch m;
    std::regex_search(str, m, re1);
    std::cout << "  ECMA (depth first search) match: " << m[0] << '\n';
    std::regex_search(str, m, re2);
    std::cout << "  POSIX (leftmost longest)  match: " << m[0] << '\n';
}

出力

Searching for .*(a|xayy) in zzxayyzz:
  ECMA (depth first search) match: zzxa
  POSIX (leftmost longest)  match: zzxayy

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 2053	C++11	定数が static で宣言されていた。	static 指定子を削除した。

関連項目

basic_regex (C++11)

正規表現オブジェクト (クラステンプレート)