Regex.GetGroupNumbers Regex.GetGroupNumbers Regex.GetGroupNumbers Regex.GetGroupNumbers Method

Определение

Возвращает массив номеров групп записи, что соответствует именам групп в массиве.Returns an array of capturing group numbers that correspond to group names in an array.

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

Возвраты

Int32[]

Целочисленный массив номеров групп.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. Регулярное выражение содержит три группы захвата: неименованные группы, который фиксирует отдельного слова вместе с символом пробела, который может следовать за ней; Группа с именем 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}'", 
                              groupNumber, 
                              ! string.IsNullOrEmpty(name) & 
                              ! Int32.TryParse(name, out number) ?
                                 " (" + name + ")" : String.Empty, 
                              m.Groups[groupNumber].Value);
         }
      } 
   }
}
// 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}'", 
                              groupNumber, 
                              If(Not String.IsNullOrEmpty(name) And 
                              Not Int32.TryParse(name, number),
                                 " (" + name + ")", String.Empty), 
                              m.Groups(groupNumber).Value)
         Next
      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+) Сопоставляется один или несколько словообразующих символов и назначить соответствующие строки в группу с именем word.Match one or more word characters and assign the matched strings to a group named word.
\s* Соответствует нулю или нескольким символам пробела.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*)+ Совпадение с шаблоном один или несколько словообразующих символов, за которым следует любой пробелы один или несколько раз.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 (ноль) представляет сопоставление в целом). Именованные группы, затем нумеруются слева направо, начиная с номером, которая на единицу больше, чем число неименованных захватываемых групп.(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.

Применяется к

Дополнительно