Regex.GroupNumberFromName(String) 메서드

정의

네임스페이스:

System.Text.RegularExpressions

어셈블리:

System.Text.RegularExpressions.dll

어셈블리:

System.dll

어셈블리:

netstandard.dll

지정된 그룹 이름에 해당하는 그룹 번호를 반환합니다.

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

해당 그룹 번호로 변환할 그룹 이름입니다.

반환

Int32

지정된 그룹 이름에 해당하는 그룹 번호이거나 name이 유효한 그룹 이름이 아닌 경우 -1입니다.

예외

ArgumentNullException

name이(가) null인 경우

설명

정규식 패턴은 패턴 일치 내에서 하위 식의 표현을 나타내는 명명된 또는 번호가 매겨진 캡처링 그룹을 포함할 수 있습니다. 번호가 매겨진 그룹은 구문(하위 식)으로 구분되며 정규식의 순서에 따라 번호가 할당됩니다. 명명된 그룹은 구문으로 구분됩니다(?< 이름> subexpression) 또는 (?' name'subexpression) 여기서 이름은 하위 식이 식별될 이름입니다. (자세한 내용은 그룹화 구문을 참조하세요.) 메서드는 GroupNumberFromName 정규식의 서수 위치로 명명된 그룹과 번호가 매겨진 그룹을 모두 식별합니다. 서수 위치 0은 항상 전체 정규식을 나타냅니다. 그런 다음 정규식 패턴의 실제 위치에 관계없이 모든 번호가 매겨진 그룹이 명명된 그룹 앞에 계산됩니다.

정규식 패턴에 있는 그룹 번호의 문자열 표현인 경우 name 메서드는 해당 숫자를 반환합니다. 정규식 패턴에 있는 명명된 캡처링 그룹에 해당하는 경우 name 메서드는 해당 번호를 반환합니다. 그룹 이름과의 name 비교는 대/소문자를 구분합니다. 캡처링 그룹의 이름 또는 캡처링 그룹 수의 문자열 표현과 일치하지 않는 경우 name 메서드는 -1을 반환합니다.

추가 정보

• GroupCollection
• GetGroupNames()
• 정규식의 그룹화 구문