Regex.GetGroupNumbers メソッド


配列内のグループ名に対応したキャプチャ グループ番号の配列を返します。Returns an array of capturing group numbers that correspond to group names in an array.

 cli::array <int> ^ GetGroupNumbers();
public int[] GetGroupNumbers ();
member this.GetGroupNumbers : unit -> int[]
Public Function GetGroupNumbers () As Integer()



グループ番号の整数配列。An integer array of group numbers.

次の例では、文に一致する正規表現 \b((?<word>\w+)\s*)+(?<end>[.?!])を定義しています。The following example defines a regular expression, \b((?<word>\w+)\s*)+(?<end>[.?!]), that matches a sentence. 正規表現には、次の3つのキャプチャグループが含まれます。個々の単語とその後に続く空白文字をキャプチャする名前のないグループ。文内の個々の単語をキャプチャする word という名前のグループ。文を終了する句読点をキャプチャする end という名前のグループ。The regular expression includes three capturing groups: an unnamed group that captures an individual word along with a space character that may follow it; a group named word that captures the individual words in the sentence; and a group named end that captures the punctuation that ends the sentence. この例では、GetGroupNumbers メソッドを呼び出してすべてのキャプチャグループの数を取得し、キャプチャした文字列を表示します。The example calls the GetGroupNumbers method to get the numbers of all capturing groups, and then displays their captured string. また、GroupNameFromNumber メソッドは、特定の番号付きグループが名前付きグループに対応するかどうかを示すために使用されます。In addition, the GroupNameFromNumber method is used to indicate whether a particular numbered group corresponds to a named group.

using System;
using System.Text.RegularExpressions;

public class Example
   public static void Main()
      string pattern = @"\b((?<word>\w+)\s*)+(?<end>[.?!])";
      string input = "This is a sentence. This is a second sentence.";
      Regex rgx = new Regex(pattern);
      int[] groupNumbers = rgx.GetGroupNumbers();
      Match m = rgx.Match(input);
      if (m.Success) {
         Console.WriteLine("Match: {0}", m.Value);
         foreach (var groupNumber in groupNumbers) {
            string name = rgx.GroupNameFromNumber(groupNumber);
            int number;
            Console.WriteLine("   Group {0}{1}: '{2}'", 
                              ! string.IsNullOrEmpty(name) & 
                              ! Int32.TryParse(name, out number) ?
                                 " (" + name + ")" : String.Empty, 
// The example displays the following output:
//       Match: This is a sentence.
//          Group 0: 'This is a sentence.'
//          Group 1: 'sentence'
//          Group 2 (word): 'sentence'
//          Group 3 (end): '.'
Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String= "\b((?<word>\w+)\s*)+(?<end>[.?!])"
      Dim input As String = "This is a sentence. This is a second sentence."
      Dim rgx As New Regex(pattern)
      Dim groupNumbers() As Integer = rgx.GetGroupNumbers()
      Dim m As Match = rgx.Match(input)
      If m.Success Then
         Console.WriteLine("Match: {0}", m.Value)
         For Each groupNumber In groupNumbers
            Dim name As String = rgx.GroupNameFromNumber(groupNumber)
            Dim number As Integer
            Console.WriteLine("   Group {0}{1}: '{2}'", 
                              If(Not String.IsNullOrEmpty(name) And 
                              Not Int32.TryParse(name, number),
                                 " (" + name + ")", String.Empty), 
      End If 
   End Sub
End Module
' The example displays the following output:
'       Match: This is a sentence.
'          Group 0: 'This is a sentence.'
'          Group 1: 'sentence'
'          Group 2 (word): 'sentence'
'          Group 3 (end): '.'

この正規表現パターンの解釈を次の表に示します。The regular expression pattern is interpreted as shown in the following table.

[パターン]Pattern 説明Description
\b ワード境界から照合を開始します。Begin the match at a word boundary.
(?<word>\w+) 1個以上の単語文字と一致し、一致した文字列を wordという名前のグループに代入します。Match one or more word characters and assign the matched strings to a group named word.
\s* 0 個以上の空白文字と一致します。Match zero or more white-space characters.
((?<word>\w+)\s*) キャプチャされたグループ word に、キャプチャされた最初のグループに対してキャプチャされた空白文字を割り当てます。Assign the word captured group followed by any captured white-space characters to the first captured group.
((?<word>\w+)\s*)+ 1個以上の単語文字の後に空白文字が1回以上続くパターンと一致します。Match the pattern of one or more word characters followed by any white-space characters one or more times.
(?<end>[.?!]) ピリオド、疑問符、または感嘆符に一致します。Match a period, question mark, or exclamation point. 一致した文字を end のキャプチャグループに割り当てます。Assign the matched character to the end capturing group.


名前のないキャプチャグループと名前付きキャプチャグループの両方に、数値でアクセスできます。Both unnamed and named capturing groups can be accessed by number. 名前のないグループには、左から右に1から順に番号が付けられます。Unnamed groups are numbered from left to right starting with 1. (インデックス 0 (ゼロ) のキャプチャグループは、照合全体を表します)。 名前付きグループには、名前のないキャプチャグループの数より1つ大きい数値から始まる番号が付けられます。(The capturing group in index 0 (zero) represents the match as a whole.) Named groups are then numbered from left to right starting with a number that is one greater than the number of unnamed capturing groups.

文字列名ではなく数値を使用してグループを参照すると、アクセスが高速になります。Referencing a group by its number instead of by string name can provide faster access.