Regex.GroupNumberFromName(String) Metoda

  • Reference

Definice

Obor názvů:
System.Text.RegularExpressions
Sestavení:
System.Text.RegularExpressions.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Vrátí číslo skupiny, které odpovídá zadanému názvu skupiny.

public:
 int GroupNumberFromName(System::String ^ name);
public int GroupNumberFromName (string name);
member this.GroupNumberFromName : string -> int
Public Function GroupNumberFromName (name As String) As Integer

Parametry

name
String

Název skupiny, který se má převést na odpovídající číslo skupiny.

Návraty

Int32

Číslo skupiny, které odpovídá zadanému názvu skupiny, nebo -1, pokud name není platný název skupiny.

Výjimky

ArgumentNullException

name je null.

Poznámky

Vzor regulárního výrazu může obsahovat pojmenované nebo číslovaný zachycené skupiny, které označují dílčí výrazy v rámci shody vzoru. Číslovanými skupinami jsou odděleny syntaxí (dílčí výraz) a jsou přiřazena čísla na základě jejich pořadí v regulárním výrazu. Pojmenované skupiny jsou oddělené syntaxí (?< Jméno> dílčí výraz) nebo (?' name'subexpression), kde název je název, kterým bude dílčí výraz identifikován. (Další informace naleznete v tématu Seskupování konstruktorů.) Metoda GroupNumberFromName identifikuje pojmenované skupiny i očíslované skupiny podle jejich pořadových pozic v regulárním výrazu. Pořadová pozice nula vždy představuje celý regulární výraz. Všechny očíslované skupiny se pak započítávají před pojmenovanými skupinami bez ohledu na jejich skutečnou pozici ve vzoru regulárního výrazu.

Pokud name je řetězcové vyjádření čísla skupiny, které je přítomné ve vzoru regulárního výrazu, metoda vrátí toto číslo. Pokud name odpovídá pojmenované zachytávání skupiny, která je přítomna ve vzoru regulárního výrazu, vrátí metoda odpovídající číslo. Porovnání name s názvem skupiny rozlišuje malá a velká písmena. Pokud name neodpovídá názvu zachytávání skupiny nebo řetězcové reprezentaci počtu zachytávání skupiny, vrátí metoda hodnotu -1.

Platí pro

Viz také