正規表現での代替構成体

代替構成体は、択一条件または条件一致を有効にするように正規表現を変更します。 .NET では、次の 3 つの代替構成体がサポートされています。

• | を使用したパターン マッチ
• (?(expression)yes|no) を使用した条件一致
• 有効なキャプチャ グループに基づく条件一致

| を使用したパターン マッチ

縦棒 (|) 文字を使って、| 文字で各パターンを区切った一連のパターンのいずれかと照合できます。

肯定的文字クラスと同じように、 | 文字を使うと、複数の文字のいずれか 1 文字と照合できます。 次の例は、肯定的文字クラスと | 文字との択一パターン マッチを使って、文字列から単語 "gray"や "grey" を検索します。 この場合、 | 文字を使うと、より詳細な正規表現が生成されます。

string pattern1 = @"\bgr[ae]y\b";
string pattern2 = @"\bgr(a|e)y\b";

string input = "The gray wolf blended in among the grey rocks.";
foreach (Match match in Regex.Matches(input, pattern1))
    Console.WriteLine($"'{match.Value}' found at position {match.Index}");
Console.WriteLine();
foreach (Match match in Regex.Matches(input, pattern2))
    Console.WriteLine($"'{match.Value}' found at position {match.Index}");

// The example displays the following output:
// 'gray' found at position 4
// 'grey' found at position 35
//
// 'gray' found at position 4
// 'grey' found at position 35

Dim pattern1 As String = "\bgr[ae]y\b"
Dim pattern2 As String = "\bgr(a|e)y\b"

Dim input As String = "The gray wolf blended in among the grey rocks."
For Each match As Match In Regex.Matches(input, pattern1)
    Console.WriteLine($"'{match.Value}' found at position {match.Index}")
Next
Console.WriteLine()
For Each match As Match In Regex.Matches(input, pattern2)
    Console.WriteLine($"'{match.Value}' found at position {match.Index}")
Next

' The example displays the following output:
' 'gray' found at position 4
' 'grey' found at position 35
'
' 'gray' found at position 4
' 'grey' found at position 35

| 文字を使う正規表現 \bgr(a|e)y\b の解釈を次の表に示します。

また、| 文字を使って、複数の文字や部分式との択一照合を実行できます。これは、文字リテラルと正規表現言語要素を自由に組み合わせて使うことができます (文字クラスにこの機能はありません)。次の例では、| 文字を使って、米国の社会保障番号 (SSN) (ddd-dd-dddd という形式の 9 桁の数字)、または米国の雇用者番号 (EIN) (dd-ddddddd という形式の 9 桁の数字) のいずれかを抽出します。

string eitherOrPattern = @"\b(\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b";
string eitherOrInput = "01-9999999 020-333333 777-88-9999";
Console.WriteLine($"Matches for {eitherOrPattern}:");
foreach (Match match in Regex.Matches(eitherOrInput, eitherOrPattern))
    Console.WriteLine($"   {match.Value} at position {match.Index}");

// The example displays the following output:
// Matches for \b(\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b:
//    01-9999999 at position 0
//    777-88-9999 at position 22

Dim eitherOrPattern As String = "\b(\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b"
Dim eitherOrInput As String = "01-9999999 020-333333 777-88-9999"
Console.WriteLine($"Matches for {eitherOrPattern}:")
For Each match As Match In Regex.Matches(eitherOrInput, eitherOrPattern)
    Console.WriteLine($"   {match.Value} at position {match.Index}")
Next

' The example displays the following output:
' Matches for \b(\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b:
'    01-9999999 at position 0
'    777-88-9999 at position 22

この正規表現 \b(\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b の解釈を次の表に示します。

式を使用した条件一致

この言語要素では、最初のパターンに一致するかどうかに応じて、2 つのパターンのいずれかの照合を実行します。 構文は次のとおりです。

(?( expression ) yes )

または

(?( expression ) yes | no )

ここで、expression は照合する最初のパターン、yes は expression が一致した場合に照合するパターン、no は expression が一致しなかった場合に照合するパターン (省略可能) です (no パターンを指定しない場合は、空の no と同じです)。 expression は正規表現エンジンによってゼロ幅アサーションとして処理されるので、 expressionが評価された後、正規表現エンジンによる入力ストリーム内の評価位置は前に進みません。 そのため、この構成体は次の構成体と同じです。

(?(?= expression ) yes | no )

ここで、 (?=expression) はゼロ幅アサーションの構成体として解釈されます (詳細は、コンストラクトのグループ化に関する記事を参照してください。) 正規表現エンジンによって expression はアンカー (ゼロ幅アサーション) として解釈されるので、expression は、ゼロ幅アサーション (詳しくはアンカーに関する記事を参照) か、yes にも含まれている部分式のいずれかである必要があります。 それ以外の場合、 yes パターンには一致しません。

次の例は、前の「| を使用したパターン マッチ」セクションで説明した例を少し変更したものです。 条件一致を使用して、ワード境界の後の最初の 3 文字が「2 桁の数字の後にハイフン」であるかどうかを判定します。 一致した場合は、米国の雇用者番号 (EIN) との照合を試みます。 一致しない場合は、米国の社会保険番号 (SSN) との照合を試みます。

string condExprPattern = @"\b(?(\d{2}-)\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b";
string condExprInput = "01-9999999 020-333333 777-88-9999";
Console.WriteLine($"Matches for {condExprPattern}:");
foreach (Match match in Regex.Matches(condExprInput, condExprPattern))
    Console.WriteLine($"   {match.Value} at position {match.Index}");

// The example displays the following output:
// Matches for \b(?(\d{2}-)\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b:
//    01-9999999 at position 0
//    777-88-9999 at position 22

Dim condExprPattern As String = "\b(?(\d{2}-)\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b"
Dim condExprInput As String = "01-9999999 020-333333 777-88-9999"
Console.WriteLine($"Matches for {condExprPattern}:")
For Each match As Match In Regex.Matches(condExprInput, condExprPattern)
    Console.WriteLine($"   {match.Value} at position {match.Index}")
Next

' The example displays the following output:
' Matches for \b(?(\d{2}-)\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b:
'    01-9999999 at position 0
'    777-88-9999 at position 22

この正規表現パターン \b(?(\d{2}-)\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b の解釈を次の表に示します。

有効なキャプチャ グループに基づく条件一致

この言語要素では、指定されたキャプチャ グループに一致するかどうかに応じて、2 つのパターンのいずれかを照合します。 構文は次のとおりです。

(?( name ) yes )

または

(?( name ) yes | no )

または

(?( number ) yes )

または

(?( number ) yes | no )

ここで、name はキャプチャ グループの名前、number はキャプチャ グループの番号です。yes は、name または number が一致する場合に照合する式です。no は、一致しない場合に照合する式 (省略可能) です (no パターンを指定しない場合は、空の no と同じです)。

name が正規表現パターンで使用されているキャプチャ グループの名前に一致しない場合、その代替構成体は式のテスト (前のセクションで説明したもの) として解釈されます。 通常、これは expression が false に評価されることを意味します。 number が正規表現パターンで使用されている番号付きキャプチャ グループに対応しない場合は、正規表現エンジンが ArgumentExceptionをスローします。

次の例は、前の「| を使用したパターン マッチ」セクションで説明した例を少し変更したものです。 「2 桁の数字の後にハイフン」で構成される n2 という名前付きキャプチャ グループを使用しています。 代替構成体により、このキャプチャ グループが入力文字列に一致したかどうかテストされます。 一致した場合は、場合に、米国の 9 桁の雇用者番号 (EIN) との照合を試みます。 一致しなかった場合は、米国の 9 桁の社会保険番号 (SSN) との照合を試みます。

string namedGroupPattern = @"\b(?<n2>\d{2}-)?(?(n2)\d{7}|\d{3}-\d{2}-\d{4})\b";
string namedGroupInput = "01-9999999 020-333333 777-88-9999";
Console.WriteLine($"Matches for {namedGroupPattern}:");
foreach (Match match in Regex.Matches(namedGroupInput, namedGroupPattern))
    Console.WriteLine($"   {match.Value} at position {match.Index}");

// The example displays the following output:
// Matches for \b(?<n2>\d{2}-)?(?(n2)\d{7}|\d{3}-\d{2}-\d{4})\b:
//    01-9999999 at position 0
//    777-88-9999 at position 22

Dim namedGroupPattern As String = "\b(?<n2>\d{2}-)?(?(n2)\d{7}|\d{3}-\d{2}-\d{4})\b"
Dim namedGroupInput As String = "01-9999999 020-333333 777-88-9999"
Console.WriteLine($"Matches for {namedGroupPattern}:")
For Each match As Match In Regex.Matches(namedGroupInput, namedGroupPattern)
    Console.WriteLine($"   {match.Value} at position {match.Index}")
Next

' The example displays the following output:
' Matches for \b(?<n2>\d{2}-)?(?(n2)\d{7}|\d{3}-\d{2}-\d{4})\b:
'    01-9999999 at position 0
'    777-88-9999 at position 22

この正規表現パターン \b(?<n2>\d{2}-)?(?(n2)\d{7}|\d{3}-\d{2}-\d{4})\b の解釈を次の表に示します。

この例を少し変更して、名前付きグループではなく番号付きグループを使用する例を次に示します。 正規表現パターンは \b(\d{2}-)?(?(1)\d{7}|\d{3}-\d{2}-\d{4})\bです。

string numberedGroupPattern = @"\b(\d{2}-)?(?(1)\d{7}|\d{3}-\d{2}-\d{4})\b";
string numberedGroupInput = "01-9999999 020-333333 777-88-9999";
Console.WriteLine($"Matches for {numberedGroupPattern}:");
foreach (Match match in Regex.Matches(numberedGroupInput, numberedGroupPattern))
    Console.WriteLine($"   {match.Value} at position {match.Index}");
// The example displays the following output:
// Matches for \b(\d{2}-)?(?(1)\d{7}|\d{3}-\d{2}-\d{4})\b:
//    01-9999999 at position 0
//    777-88-9999 at position 22

Dim numberedGroupPattern As String = "\b(\d{2}-)?(?(1)\d{7}|\d{3}-\d{2}-\d{4})\b"
Dim numberedGroupInput As String = "01-9999999 020-333333 777-88-9999"
Console.WriteLine($"Matches for {numberedGroupPattern}:")
For Each match As Match In Regex.Matches(numberedGroupInput, numberedGroupPattern)
    Console.WriteLine($"   {match.Value} at position {match.Index}")
Next

' The example displays the following output:
' Matches for \b(\d{2}-)?(?(1)\d{7}|\d{3}-\d{2}-\d{4})\b:
'    01-9999999 at position 0
'    777-88-9999 at position 22

関連項目

• 正規表現言語 - クイック リファレンス