Group クラス

定義

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

public class Group : System.Text.RegularExpressions.Capture

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

type Group = class
    inherit Capture

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

Public Class Group
Inherits Capture

継承

Object

Capture

Group

派生

System.Text.RegularExpressions.Match

属性

SerializableAttribute

注釈

キャプチャ グループでは、量指定子のため、1 つの一致で 0 個、1 つ以上の文字列をキャプチャできます。 (詳細については、「 量指定子」を参照してください)。1 つのキャプチャ グループと一致するすべての部分文字列は、 Group.Captures プロパティから使用できます。 キャプチャされた最後の部分文字列に関する情報は、 Value および Index プロパティから直接アクセスできます。 (つまり、 Group インスタンスは、キャプチャ グループによって行われた最後のキャプチャを反映する、 Captures プロパティによって返されるコレクションの最後の項目と同じです)。

たとえば、Group オブジェクトと、Captures プロパティによって返されるSystem.Text.RegularExpressions.CaptureCollectionとの間のこの関係を明確にするのに役立ちます。 正規表現パターン (\b(\w+?)[,:;]?\s?)+[?.!] 文全体に一致します。 正規表現は、次の表に示すように定義されています。

この正規表現パターンでは、サブパターン (\w+?) は、文内の複数の単語と一致するように設計されています。 ただし、 Group オブジェクトの値はキャプチャ (\w+?) 最後の一致のみを表しますが、 Captures プロパティはキャプチャされたすべてのテキストを表す CaptureCollection を返します。 出力が示すように、2 番目のキャプチャ グループの CaptureCollection には 4 つのオブジェクトが含まれています。 これらの最後のオブジェクトは、 Group オブジェクトに対応します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"(\b(\w+?)[,:;]?\s?)+[?.!]";
      string input = "This is one sentence. This is a second sentence.";

      Match match = Regex.Match(input, pattern);
      Console.WriteLine("Match: " + match.Value);
      int groupCtr = 0;
      foreach (Group group in match.Groups)
      {
         groupCtr++;
         Console.WriteLine("   Group {0}: '{1}'", groupCtr, group.Value);
         int captureCtr = 0;
         foreach (Capture capture in group.Captures)
         {
            captureCtr++;
            Console.WriteLine("      Capture {0}: '{1}'", captureCtr, capture.Value);
         }
      }   
   }
}
// The example displays the following output:
//       Match: This is one sentence.
//          Group 1: 'This is one sentence.'
//             Capture 1: 'This is one sentence.'
//          Group 2: 'sentence'
//             Capture 1: 'This '
//             Capture 2: 'is '
//             Capture 3: 'one '
//             Capture 4: 'sentence'
//          Group 3: 'sentence'
//             Capture 1: 'This'
//             Capture 2: 'is'
//             Capture 3: 'one'
//             Capture 4: 'sentence'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(\b(\w+?)[,:;]?\s?)+[?.!]"
      Dim input As String = "This is one sentence. This is a second sentence."

      Dim match As Match = Regex.Match(input, pattern)
      Console.WriteLine("Match: " + match.Value)
      Dim groupCtr As Integer = 0
      For Each group As Group In match.Groups
         groupCtr += 1
         Console.WriteLine("   Group {0}: '{1}'", groupCtr, group.Value)
         Dim captureCtr As Integer = 0
         For Each capture As Capture In group.Captures
            captureCtr += 1
            Console.WriteLine("      Capture {0}: '{1}'", captureCtr, capture.Value)
         Next
      Next   
   End Sub
End Module
' The example displays the following output:
'       Match: This is one sentence.
'          Group 1: 'This is one sentence.'
'             Capture 1: 'This is one sentence.'
'          Group 2: 'sentence'
'             Capture 1: 'This '
'             Capture 2: 'is '
'             Capture 3: 'one '
'             Capture 4: 'sentence'
'          Group 3: 'sentence'
'             Capture 1: 'This'
'             Capture 2: 'is'
'             Capture 3: 'one'
'             Capture 4: 'sentence'