Regex.GroupNumberFromName(String) メソッド

定義

指定したグループ名に対応するグループ番号を返します。

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

パラメーター

name
String

対応するグループ番号に変換するグループ名。

戻り値

指定したグループ名に対応するグループ番号。name が有効なグループ名でない場合は -1。

例外

namenullです。

注釈

正規表現パターンには、名前付きキャプチャ グループまたは番号付きキャプチャ グループを含め、パターン 一致内の部分式を示します。 番号付きグループは構文 (部分式) で区切られ、正規表現の順序に基づいて番号が割り当てられます。 名前付きグループは構文 (?<名前>subexpression)または (?'name'subexpression)、ここで name は、部分式を識別する名前です。 (詳細については、「 グループ化コンストラクト」を参照してください)。メソッドは GroupNumberFromName 、名前付きグループと番号付きグループの両方を、正規表現内の序数位置によって識別します。 序数位置 0 は、常に正規表現全体を表します。 その後、正規表現パターンでの実際の位置に関係なく、すべての番号付きグループは名前付きグループの前にカウントされます。

が正規表現パターンに存在するグループ番号の文字列表現である場合 name 、メソッドはその番号を返します。 正規表現パターンに存在する名前付きキャプチャ グループに対応する場合 name 、メソッドは対応する数値を返します。 グループ名との比較 name では、大文字と小文字が区別されます。 がキャプチャ グループの名前またはキャプチャ グループの番号の文字列表現に対応しない場合 name 、メソッドは -1 を返します。

適用対象

こちらもご覧ください