Match クラス

リファレンス

定義

名前空間:: System.Text.RegularExpressions

アセンブリ:: System.Text.RegularExpressions.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

1 回の正規表現検索に一致した結果を表します。

public ref class Match : System::Text::RegularExpressions::Group

public class Match : System.Text.RegularExpressions.Group

[System.Serializable]
public class Match : System.Text.RegularExpressions.Group

type Match = class
    inherit Group

[<System.Serializable>]
type Match = class
    inherit Group

Public Class Match
Inherits Group

継承: Object

Capture

Group
Match

属性: SerializableAttribute

例

次の例では、正規表現 Console\.Write(Line)?を使用します。この正規表現パターンは、次のように解釈されます。


コンソール\。書き込み	文字列 "Console.Write" と一致します。 "." 文字はエスケープされるため、任意の文字に一致するワイルドカードとしてではなく、リテラルピリオドとして解釈されることに注意してください。
(行)?	文字列 "Line" の 0 回または 1 回の繰り返しに一致します。

例 1

次の例では、メソッドを Regex.Matches(String, String) 呼び出して、入力文字列内のすべてのパターン一致を取得します。次に、返されたMatchCollectionオブジェクト内のMatchオブジェクトを反復処理して、各一致に関する情報を表示します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "int[] values = { 1, 2, 3 };\n" +
                     "for (int ctr = values.GetLowerBound(1); ctr <= values.GetUpperBound(1); ctr++)\n" +
                     "{\n" +
                     "   Console.Write(values[ctr]);\n" +
                     "   if (ctr < values.GetUpperBound(1))\n" +
                     "      Console.Write(\", \");\n" +
                     "}\n" +
                     "Console.WriteLine();\n";   
      
      string pattern = @"Console\.Write(Line)?";
      MatchCollection matches = Regex.Matches(input, pattern);
      foreach (Match match in matches)
         Console.WriteLine("'{0}' found in the source code at position {1}.",  
                           match.Value, match.Index);
   }
}
// The example displays the following output:
//    'Console.Write' found in the source code at position 112.
//    'Console.Write' found in the source code at position 184.
//    'Console.WriteLine' found in the source code at position 207.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "Dim values() As Integer = { 1, 2, 3 }" & vbCrLf & _
                            "For ctr As Integer = values.GetLowerBound(1) To values.GetUpperBound(1)" & vbCrLf & _
                            "   Console.Write(values(ctr))" & vbCrLf & _
                            "   If ctr < values.GetUpperBound(1) Then Console.Write("", "")" & vbCrLf & _
                            "Next" & vbCrLf & _
                            "Console.WriteLine()"   
      Dim pattern As String = "Console\.Write(Line)?"
      Dim matches As MatchCollection = Regex.Matches(input, pattern)
      For Each match As Match In matches
         Console.WriteLine("'{0}' found in the source code at position {1}.", _ 
                           match.Value, match.Index)       
      Next                            
   End Sub
End Module
' The example displays the following output:
'    'Console.Write' found in the source code at position 115.
'    'Console.Write' found in the source code at position 184.
'    'Console.WriteLine' found in the source code at position 211.

例 2

次の例では、一度に Match(String, String) 1 つの一致を取得するメソッドと NextMatch メソッドを呼び出します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "int[] values = { 1, 2, 3 };\n" +
                     "for (int ctr = values.GetLowerBound(1); ctr <= values.GetUpperBound(1); ctr++)\n" +
                     "{\n" +
                     "   Console.Write(values[ctr]);\n" +
                     "   if (ctr < values.GetUpperBound(1))\n" +
                     "      Console.Write(\", \");\n" +
                     "}\n" +
                     "Console.WriteLine();\n";   
      string pattern = @"Console\.Write(Line)?";
      Match match = Regex.Match(input, pattern);
      while (match.Success)
      {
         Console.WriteLine("'{0}' found in the source code at position {1}.",  
                           match.Value, match.Index);
         match = match.NextMatch();
      }
   }
}
// The example displays the following output:
//    'Console.Write' found in the source code at position 112.
//    'Console.Write' found in the source code at position 184.
//    'Console.WriteLine' found in the source code at position 207.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "Dim values() As Integer = { 1, 2, 3 }" & vbCrLf & _
                            "For ctr As Integer = values.GetLowerBound(1) To values.GetUpperBound(1)" & vbCrLf & _
                            "   Console.Write(values(ctr))" & vbCrLf & _
                            "   If ctr < values.GetUpperBound(1) Then Console.Write("", "")" & vbCrLf & _
                            "Next" & vbCrLf & _
                            "Console.WriteLine()"   
      Dim pattern As String = "Console\.Write(Line)?"
      Dim match As Match = Regex.Match(input, pattern)
      Do While match.Success
         Console.WriteLine("'{0}' found in the source code at position {1}.", _ 
                           match.Value, match.Index)
         match = match.NextMatch()                  
      Loop                            
   End Sub
End Module
' The example displays the following output:
'    'Console.Write' found in the source code at position 115.
'    'Console.Write' found in the source code at position 184.
'    'Console.WriteLine' found in the source code at position 211.

注釈

オブジェクトは Match 不変であり、パブリックコンストラクターがありません。クラスの Match インスタンスはメソッドによって Regex.Match 返され、文字列内の最初のパターン一致を表します。後続の一致は、メソッドによって Match 返されるオブジェクトによって Match.NextMatch 表されます。さらに、 MatchCollection 0 個、1 つ以上 Match のオブジェクトで構成されるオブジェクトは、メソッドによって Regex.Matches 返されます。

メソッドが Regex.Matches 入力文字列内の正規表現パターンと一致しない場合は、空 MatchCollection のオブジェクトが返されます。その後、C# のコンストラクトを使用するか、Visual Basic内のコンストラクトをFor Each使用foreachしてコレクションを反復処理できます。

メソッドがRegex.Match正規表現パターンと一致しない場合は、次のMatch.Emptyオブジェクトが返Matchされます。このプロパティを Success 使用して、一致が成功したかどうかを判断できます。具体的な例を次に示します。

// Search for a pattern that is not found in the input string.
string pattern = "dog";
string input = "The cat saw the other cats playing in the back yard.";
Match match = Regex.Match(input, pattern);
if (match.Success )
   // Report position as a one-based integer.
   Console.WriteLine("'{0}' was found at position {1} in '{2}'.", 
                     match.Value, match.Index + 1, input);
else
   Console.WriteLine("The pattern '{0}' was not found in '{1}'.",
                     pattern, input);

' Search for a pattern that is not found in the input string.
Dim pattern As String = "dog"
Dim input As String = "The cat saw the other cats playing in the back yard."
Dim match As Match = Regex.Match(input, pattern)
If match.Success Then
   ' Report position as a one-based integer.
   Console.WriteLine("'{0}' was found at position {1} in '{2}'.", _ 
                     match.Value, match.Index + 1, input)
Else
   Console.WriteLine("The pattern '{0}' was not found in '{1}'.", _
                     pattern, input)
End If

パターンの一致が成功した場合、 Value プロパティには一致する部分文字列が含まれており、 Index プロパティは入力文字列内の一致する部分文字列の 0 から始まる開始位置を示し Length 、プロパティは入力文字列内の一致する部分文字列の長さを示します。

1 つの一致に複数のキャプチャグループが含まれる可能性があるため、 Match Groups GroupCollection. Matchインスタンス自体は、Match.Groups[0]コレクション内の最初のオブジェクト (Visual Basic) と同じです。Match.Groups(0)これは一致全体を表します。キャプチャしたグループには、次の方法で一致してアクセスできます。

(C#) または For Each (Visual Basic) コンストラクトをforeach使用して、オブジェクトのメンバーGroupCollectionを反復処理できます。
このプロパティを GroupCollection.Item[Int32] 使用すると、キャプチャグループの数によってグループを取得できます。インスタンス Regex.GetGroupNumbers メソッドを呼び出すことで、正規表現に存在する番号付きグループを特定できます。
このプロパティを GroupCollection.Item[String] 使用すると、キャプチャグループの名前でグループを取得できます。インスタンス Regex.GetGroupNames() メソッドを呼び出すことで、正規表現に存在する名前付きグループを特定できます。

プロパティ

Captures	内側と左側が先の順序で、キャプチャグループに一致したすべてのキャプチャ結果のコレクションを取得します。または、正規表現が RightToLeft オプションを使用して変更されている場合は、内側と右端が先の順序で取得します。このコレクションには 0 個以上の項目が格納されています。 (継承元 Group)
Empty	空のグループを取得します。一致する対象が見つからなかった検索は、この空一致を返します。
Groups	正規表現に一致したグループのコレクションを取得します。
Index	キャプチャした部分文字列の最初の文字が見つかる元の文字列内の位置。 (継承元 Capture)
Length	キャプチャした部分文字列の長さを取得します。 (継承元 Capture)
Name	現在のインスタンスで表されるキャプチャグループの名前を返します。 (継承元 Group)
Success	一致した対象が見つかったかどうかを示す値を取得します。 (継承元 Group)
Value	入力文字列からキャプチャした部分文字列を取得します。 (継承元 Capture)
ValueSpan	入力文字列からキャプチャされたスパンを取得します。 (継承元 Capture)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
NextMatch()	一致する対象が最後に見つかった位置の終了位置 (最後に一致した文字の後の文字) から開始して、次に一致する対象を検索した結果の新しい Match オブジェクトを返します。
Result(String)	指定された置換パターンを展開して返します。
Synchronized(Match)	指定されたオブジェクトと等価であり、かつ複数のスレッド間での共有に適した Match インスタンスを返します。
ToString()	Value プロパティを呼び出して、入力文字列からキャプチャされた部分文字列を取得します。 (継承元 Capture)

適用対象

Match クラス

定義

例

注釈

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース