Regex.GetGroupNumbers Método

Definição

Retorna uma matriz de números de grupo de captura que correspondem aos nomes de grupos em uma matriz.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()

Retornos

Int32[]

Uma matriz de inteiros de números de grupo.An integer array of group numbers.

Exemplos

O exemplo a seguir define uma expressão regular, \b((?<word>\w+)\s*)+(?<end>[.?!]), que corresponde a uma frase.The following example defines a regular expression, \b((?<word>\w+)\s*)+(?<end>[.?!]), that matches a sentence. A expressão regular inclui três grupos de captura: um grupo sem nome que captura uma palavra individual junto com um caractere de espaço que pode ser seguido; um grupo chamado word que captura as palavras individuais na sentença; e um grupo chamado end que captura a pontuação que termina a sentença.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. O exemplo chama o método GetGroupNumbers para obter os números de todos os grupos de captura e, em seguida, exibe a cadeia de caracteres capturada.The example calls the GetGroupNumbers method to get the numbers of all capturing groups, and then displays their captured string. Além disso, o método GroupNameFromNumber é usado para indicar se um determinado grupo numerado corresponde a um grupo nomeado.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): '.'

O padrão da expressão regular é interpretado conforme a tabela a seguir.The regular expression pattern is interpreted as shown in the following table.

PadrãoPattern DESCRIÇÃODescription
\b Começa a correspondência em um limite de palavra.Begin the match at a word boundary.
(?<word>\w+) Corresponda a um ou mais caracteres de palavra e atribua as cadeias correspondentes a um grupo chamado word.Match one or more word characters and assign the matched strings to a group named word.
\s* Corresponder a zero ou mais caracteres de espaço em branco.Match zero or more white-space characters.
((?<word>\w+)\s*) Atribua o word grupo capturado seguido por quaisquer caracteres de espaço em branco capturados para o primeiro grupo capturado.Assign the word captured group followed by any captured white-space characters to the first captured group.
((?<word>\w+)\s*)+ Corresponder o padrão de um ou mais caracteres de palavra seguidos por qualquer caractere de espaço em branco uma ou mais vezes.Match the pattern of one or more word characters followed by any white-space characters one or more times.
(?<end>[.?!]) Corresponde a um ponto, um ponto de interrogação ou um ponto de exclamação.Match a period, question mark, or exclamation point. Atribua o caractere correspondente ao grupo de captura end.Assign the matched character to the end capturing group.

Comentários

Os grupos de captura sem nome e nomeados podem ser acessados pelo número.Both unnamed and named capturing groups can be accessed by number. Os grupos sem nome são numerados da esquerda para a direita, começando com 1.Unnamed groups are numbered from left to right starting with 1. (O grupo de captura no índice 0 (zero) representa a correspondência como um todo.) Os grupos nomeados são numerados da esquerda para a direita, começando com um número maior que o número de grupos de captura sem nome.(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.

A referência a um grupo por seu número, em vez de pelo nome da cadeia de caracteres, pode fornecer acesso mais rápido.Referencing a group by its number instead of by string name can provide faster access.

Aplica-se a

Veja também