Regex.Match 메서드

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input);

public System.Text.RegularExpressions.Match Match(string input);

member this.Match : string -> System.Text.RegularExpressions.Match

Public Function Match (input As String) As Match

매개 변수

반품

일치 항목에 대한 정보가 들어 있는 개체입니다.

예외

설명

이 메서드는 Match(String) 입력 문자열의 정규식 패턴과 일치하는 첫 번째 부분 문자열을 반환합니다.

반환 Match 된 개체 Success 의 속성을 확인하여 입력 문자열에서 정규식 패턴이 발견되었는지 여부를 확인할 수 있습니다. 일치 항목이 발견되면 반환 Match 된 개체의 Value 속성에 일치하는 부분 문자열이 포함됩니다. 일치하는 항목이 없으면 값이 Empty입니다.

이 메서드는 첫 번째 일치 항목을 반환합니다. 반환된 Match 개체의 NextMatch() 메서드를 반복적으로 호출하여 후속 일치 항목을 검색할 수 있습니다. 호출하여 단일 메서드 호출에서 모든 일치 항목을 검색할 Matches(String)수도 있습니다.

일치하는 작업의 실행 시간이 RegexMatchTimeoutException 생성자가 지정한 제한 시간 간격을 초과하면 Regex(String, RegexOptions, TimeSpan) 예외가 throw됩니다. 생성자를 호출할 때 제한 시간 간격을 설정하지 않으면 작업이 Regex 개체가 만들어진 애플리케이션 도메인에 대해 설정된 제한 시간 값을 초과하면 예외가 throw됩니다. Regex 생성자 호출 또는 애플리케이션 도메인의 속성에 제한 시간이 정의되지 않거나 시간 제한 값이 InfiniteMatchTimeout경우 예외가 throw되지 않습니다.

추가 정보

• NextMatch()
• 정규식 언어 - 빠른 참조

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input, int startat);

public System.Text.RegularExpressions.Match Match(string input, int startat);

member this.Match : string * int -> System.Text.RegularExpressions.Match

Public Function Match (input As String, startat As Integer) As Match

매개 변수

반품

일치 항목에 대한 정보가 들어 있는 개체입니다.

예외

설명

자세한 startat내용은 Regex.Match에 대한 추가 API 비고를 참조하세요.

추가 정보

• NextMatch()
• 정규식 언어 - 빠른 참조

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern);

public static System.Text.RegularExpressions.Match Match(string input, string pattern);

static member Match : string * string -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String) As Match

매개 변수

반품

일치 항목에 대한 정보가 들어 있는 개체입니다.

예외

설명

정적 Match(String, String) 메서드는 지정된 패턴으로 개체를 Regex 생성하고 인스턴스 Match(String) 메서드를 호출하는 것과 같습니다. 정규식 엔진은 패턴을 캐시합니다.

반환 Match 된 개체 Success 의 속성을 확인하여 입력 문자열에서 정규식 패턴이 발견되었는지 여부를 확인할 수 있습니다. 일치 항목이 발견되면 반환 Match 된 개체의 Value 속성에 일치하는 부분 문자열이 포함됩니다. 일치하는 항목이 없으면 값이 Empty입니다.

반환된 Match 개체의 NextMatch() 메서드를 반복적으로 호출하여 후속 일치 항목을 검색할 수 있습니다. Matches(String, String) 메서드를 호출하여 단일 메서드 호출에서 모든 일치 항목을 검색할 수도 있습니다.

호출자 참고

이 메서드는 호출되는 애플리케이션 도메인의 기본 제한 시간 값과 동일한 간격 후에 시간 초과됩니다. 애플리케이션 도메인에 대한 제한 시간 값이 정의되지 않은 경우 메서드의 시간 초과를 방지하는 값 InfiniteMatchTimeout이 사용됩니다. 패턴 일치를 검색하는 데 권장되는 정적 메서드는 Match(String, String)제한 시간 간격을 설정할 수 있는 것입니다.

추가 정보

• NextMatch()
• 정규식 언어 - 빠른 참조

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input, int beginning, int length);

public System.Text.RegularExpressions.Match Match(string input, int beginning, int length);

member this.Match : string * int * int -> System.Text.RegularExpressions.Match

Public Function Match (input As String, beginning As Integer, length As Integer) As Match

매개 변수

반품

일치 항목에 대한 정보가 들어 있는 개체입니다.

예외

설명

메서드는 Match(String, Int32, Int32) 정규식 패턴에 input 대해 매개 변수 및 beginning 매개 변수로 정의된 부분을 length 검색합니다. beginning 항상 검색에 포함할 가장 왼쪽 문자의 인덱스를 정의하고 length 검색할 최대 문자 수를 정의합니다. 함께 검색 범위를 정의합니다. 동작은 일치 항목의 인덱스가 시작 input부분을 기준으로 계산된다는 점을 제외하고 입력이 효과적으로 input.Substring(beginning, length)적용된 것처럼 정확하게 표시됩니다. 즉, 패턴의 시작 또는 끝에 있는 앵커 또는 너비가 0인 어설션은 이 범위 밖에 입력이 없는 것처럼 동작합니다.

검색이 왼쪽에서 오른쪽(기본값)으로 진행되는 경우 정규식 엔진은 인덱스의 문자에서 인덱 beginningbeginning + length 스의 문자 -1로 검색합니다. 이 옵션을 사용하여 RightToLeft 정규식 엔진을 인스턴스화한 경우 엔진은 인덱스 -1의 문자에서 인덱lengthbeginning + beginning스 문자로 검색합니다.

이 메서드는 이 범위 내에 있는 첫 번째 일치 항목을 반환합니다. 반환된 Match 개체의 NextMatch() 메서드를 반복적으로 호출하여 후속 일치 항목을 검색할 수 있습니다.

추가 정보

• NextMatch()
• 정규식 언어 - 빠른 참조

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static System.Text.RegularExpressions.Match Match(string input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member Match : string * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String, options As RegexOptions) As Match

매개 변수

반품

일치 항목에 대한 정보가 들어 있는 개체입니다.

예외

설명

정적 Match(String, String, RegexOptions) 메서드는 생성자를 사용하여 개체 Regex 를 Regex(String, RegexOptions) 생성하고 인스턴스 Match(String) 메서드를 호출하는 것과 같습니다.

반환 Match 된 개체 Success 의 속성을 확인하여 입력 문자열에서 정규식 패턴이 발견되었는지 여부를 확인할 수 있습니다. 반환된 Match 개체의 NextMatch() 메서드를 반복적으로 호출하여 후속 일치 항목을 검색할 수 있습니다. Matches(String, String, RegexOptions) 메서드를 호출하여 단일 메서드 호출에서 모든 일치 항목을 검색할 수도 있습니다.

호출자 참고

이 메서드는 호출되는 애플리케이션 도메인의 기본 제한 시간 값과 동일한 간격 후에 시간 초과됩니다. 애플리케이션 도메인에 대한 제한 시간 값이 정의되지 않은 경우 메서드의 시간 초과를 방지하는 값 InfiniteMatchTimeout이 사용됩니다. 패턴 일치를 검색하는 데 권장되는 정적 메서드는 Match(String, String)제한 시간 간격을 설정할 수 있는 것입니다.

추가 정보

• NextMatch()
• 정규식 언어 - 빠른 참조

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

Source:

Regex.Match.cs

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static System.Text.RegularExpressions.Match Match(string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Match : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Match

매개 변수

반품

일치 항목에 대한 정보가 들어 있는 개체입니다.

예외

설명

정적 Match(String, String, RegexOptions, TimeSpan) 메서드는 생성자를 사용하여 개체 Regex 를 Regex(String, RegexOptions, TimeSpan) 생성하고 인스턴스 Match(String) 메서드를 호출하는 것과 같습니다.

반환 Match 된 개체 Success 의 속성을 확인하여 입력 문자열에서 정규식 패턴이 발견되었는지 여부를 확인할 수 있습니다. 반환된 Match 개체의 NextMatch() 메서드를 반복적으로 호출하여 후속 일치 항목을 검색할 수 있습니다.

매개 변수는 matchTimeout 패턴 일치 메서드가 시간 초과되기 전에 일치 항목을 찾으려고 시도하는 기간을 지정합니다. 제한 시간 간격을 설정하면 과도한 역추적에 의존하는 정규식이 가까운 일치 항목이 포함된 입력을 처리할 때 응답을 중지하는 것처럼 보이지 않습니다. 해당 시간 간격에 일치하는 항목이 없으면 메서드가 예외를 RegexMatchTimeoutException throw합니다. matchTimeout 메서드가 실행되는 애플리케이션 도메인에 대해 정의된 기본 제한 시간 값을 재정의합니다.

호출자 참고

매개 변수를 matchTimeout 2초와 같은 적절한 값으로 설정하는 것이 좋습니다. 지정하여 InfiniteMatchTimeout시간 초과를 사용하지 않도록 설정하면 정규식 엔진이 약간 더 나은 성능을 제공합니다. 그러나 다음 조건에서만 시간 초과를 사용하지 않도록 설정해야 합니다.

• 정규식에서 처리된 입력이 알려진 신뢰할 수 있는 원본에서 파생되거나 정적 텍스트로 구성된 경우 사용자가 동적으로 입력한 텍스트는 제외됩니다.

• 정규식 패턴을 철저히 테스트하여 일치 항목, 비 일치 항목 및 근사 일치 항목을 효율적으로 처리하는지 확인합니다.

• 정규식 패턴에 거의 일치 항목을 처리할 때 과도한 역추적을 일으키는 것으로 알려진 언어 요소가 없는 경우

추가 정보

• 정규식 언어 - 빠른 참조