Regex.GroupNumberFromName(String) メソッド

定義

指定したグループ名に対応するグループ番号を返します。Returns the group number that corresponds to the specified group name.

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

対応するグループ番号に変換するグループ名。The group name to convert to the corresponding group number.

戻り値

指定したグループ名に対応するグループ番号。name が有効なグループ名でない場合は -1。The group number that corresponds to the specified group name, or -1 if name is not a valid group name.

例外

namenull です。name is null.

注釈

正規表現パターンには、名前付きまたは番号付きのキャプチャグループを含めることができます。これは、パターンマッチ内の部分式を表します。A regular expression pattern may contain either named or numbered capturing groups, which delineate subexpressions within a pattern match. 番号付きグループは構文 (部分式) で区切られ、正規表現の順序に基づいて番号が割り当てられます。Numbered groups are delimited by the syntax (subexpression) and are assigned numbers based on their order in the regular expression. 名前付きグループは、構文 (?<name>部分式) または (?) で区切られます。名前'部分式)。ここで、 nameは部分式の識別に使用される名前です。Named groups are delimited by the syntax (?<name>subexpression) or (?'name'subexpression), where name is the name by which the subexpression will be identified. (詳細については、「グループ化構成体」を参照してください)。GroupNumberFromName メソッドは、正規表現内の序数位置によって名前付きグループと番号付きグループの両方を識別します。(For more information, see Grouping Constructs.) The GroupNumberFromName method identifies both named groups and numbered groups by their ordinal positions in the regular expression. 序数位置0は、常に正規表現全体を表します。Ordinal position zero always represents the entire regular expression. 正規表現パターンの実際の位置に関係なく、すべての番号付きグループは名前付きグループの前にカウントされます。All numbered groups are then counted before named groups, regardless of their actual position in the regular expression pattern.

name が正規表現パターンに含まれるグループ番号の文字列表現である場合、メソッドはその数値を返します。If name is the string representation of a group number that is present in the regular expression pattern, the method returns that number. name が正規表現パターンに存在する名前付きキャプチャグループに対応している場合、メソッドは対応する数値を返します。If name corresponds to a named capturing group that is present in the regular expression pattern, the method returns its corresponding number. グループ名と name の比較では、大文字と小文字が区別されます。The comparison of name with the group name is case-sensitive. name がキャプチャグループの名前またはキャプチャグループの番号の文字列形式に対応していない場合、メソッドは-1 を返します。If name does not correspond to the name of a capturing group or to the string representation of the number of a capturing group, the method returns -1.

適用対象

こちらもご覧ください