Group.Captures プロパティ

public:
 property System::Text::RegularExpressions::CaptureCollection ^ Captures { System::Text::RegularExpressions::CaptureCollection ^ get(); };

public System.Text.RegularExpressions.CaptureCollection Captures { get; }

member this.Captures : System.Text.RegularExpressions.CaptureCollection

Public ReadOnly Property Captures As CaptureCollection

プロパティ値

CaptureCollection

グループに一致した部分文字列のコレクション。

注釈

量指定子がキャプチャ グループに適用されていない場合、プロパティによって Captures 返されるコレクションには、オブジェクトと同じ部分文字列に関する情報を提供する 1 つの Capture オブジェクトが Group 含まれます。 この例を次に示します。 これは、 \b(\w+)\b文から 1 つの単語を抽出する正規表現を定義します。 オブジェクトは Group "This" という単語をキャプチャし、その中の CaptureCollection 1 つのオブジェクトには同じキャプチャに関する情報が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\b(\w+)\b";
      string input = "This is one sentence.";
      Match match = Regex.Match(input, pattern);
      if (match.Success) {
         Console.WriteLine("Matched text: {0}", match.Value);
         for (int ctr = 1; ctr <= match.Groups.Count - 1; ctr++) {
            Console.WriteLine("   Group {0}:  {1}", ctr, match.Groups[ctr].Value);
            int captureCtr = 0;
            foreach (Capture capture in match.Groups[ctr].Captures) {
               Console.WriteLine("      Capture {0}: {1}", 
                                 captureCtr, capture.Value);
               captureCtr += 1;                  
            }
         }
      }   
   }
}
// The example displays the following output:
//       Matched text: This
//          Group 1:  This
//             Capture 0: This

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\b(\w+)\b"
      Dim input As String = "This is one sentence."
      Dim match As Match = Regex.Match(input, pattern)
      If match.Success Then
         Console.WriteLine("Matched text: {0}", match.Value)
         For ctr As Integer = 1 To match.Groups.Count - 1
            Console.WriteLine("   Group {0}:  {1}", ctr, match.Groups(ctr).Value)
            Dim captureCtr As Integer = 0
            For Each capture As Capture In match.Groups(ctr).Captures
               Console.WriteLine("      Capture {0}: {1}", _
                                 captureCtr, capture.Value)
               captureCtr += 1                  
            Next
         Next
      End If   
   End Sub
End Module
' The example displays the following output:
'       Matched text: This
'          Group 1:  This
'             Capture 0: This

プロパティの実際の Captures ユーティリティは、量指定子がキャプチャ グループに適用され、グループが 1 つの正規表現で複数の部分文字列をキャプチャする場合に発生します。 この場合、オブジェクトには最後に Group キャプチャされた部分文字列に関する情報が含まれますが Captures 、プロパティにはグループによってキャプチャされたすべての部分文字列に関する情報が含まれます。 次の例では、正規表現 \b(\w+\s*)+\. はピリオドで終わる文全体と一致します。 グループ (\w+\s*)+ は、コレクション内の個々の単語をキャプチャします。 コレクションには最後に Group キャプチャされた部分文字列に関する情報のみが含まれているため、文の最後の単語 "sentence" がキャプチャされます。 ただし、グループによってキャプチャされた各単語は、プロパティによって Captures 返されるコレクションから使用できます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "This is a sentence. This is another sentence.";
      string pattern = @"\b(\w+\s*)+\.";
      Match match = Regex.Match(input, pattern);
      if (match.Success) {
         Console.WriteLine("Matched text: {0}", match.Value);
         for (int ctr = 1; ctr < match.Groups.Count; ctr++) {
            Console.WriteLine("   Group {0}:  {1}", ctr, match.Groups[ctr].Value);
            int captureCtr = 0;
            foreach (Capture capture in match.Groups[ctr].Captures) {
               Console.WriteLine("      Capture {0}: {1}", 
                                 captureCtr, capture.Value);
               captureCtr++; 
            }
         }
      }   
   }
}
// The example displays the following output:
//       Matched text: This is a sentence.
//          Group 1:  sentence
//             Capture 0: This
//             Capture 1: is
//             Capture 2: a
//             Capture 3: sentence

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "This is a sentence. This is another sentence."
      Dim pattern As String = "\b(\w+\s*)+\."
      Dim match As Match = Regex.Match(input, pattern)
      If match.Success Then
         Console.WriteLine("Matched text: {0}", match.Value)
         For ctr As Integer = 1 To match.Groups.Count - 1
            Console.WriteLine("   Group {0}:  {1}", ctr, match.Groups(ctr).Value)
            Dim captureCtr As Integer = 0
            For Each capture As Capture In match.Groups(ctr).Captures
               Console.WriteLine("      Capture {0}: {1}", _
                                 captureCtr, capture.Value)
               captureCtr += 1                  
            Next
         Next
      End If   
   End Sub
End Module
' The example displays the following output:
'       Matched text: This is a sentence.
'          Group 1:  sentence
'             Capture 0: This
'             Capture 1: is
'             Capture 2: a
'             Capture 3: sentence

適用対象

こちらもご覧ください

• 正規表現でのコンストラクトのグループ化
• 量指定子 (正規表現)