Regex.Match Metoda

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

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

Parametry

Zwraca

Obiekt zawierający informacje o dopasowaniu.

Wyjątki

Uwagi

Metoda Match(String) zwraca pierwszy podciąg zgodny ze wzorcem wyrażenia regularnego w ciągu wejściowym.

Można określić, czy wzorzec wyrażenia regularnego został znaleziony w ciągu wejściowym, sprawdzając właściwość zwróconego MatchSuccess obiektu. Jeśli zostanie znalezione dopasowanie, właściwość zwróconego Match obiektu Value zawiera pasujący podciąg. Jeśli nie zostanie znalezione dopasowanie, jego wartość jest Empty.

Ta metoda zwraca pierwsze dopasowanie. Kolejne dopasowania można pobrać, wielokrotnie wywołując zwracaną metodę Match obiektu NextMatch(). Można również pobrać wszystkie dopasowania w jednym wywołaniu metody, wywołując metodę Matches(String).

Wyjątek RegexMatchTimeoutException jest zgłaszany, jeśli czas wykonywania pasującej operacji przekracza interwał limitu czasu określony przez konstruktora Regex(String, RegexOptions, TimeSpan). Jeśli nie ustawisz interwału przekroczenia limitu czasu podczas wywoływania konstruktora, wyjątek jest zgłaszany, jeśli operacja przekracza wartość limitu czasu ustanowioną dla domeny aplikacji, w której jest tworzony obiekt Regex. Jeśli w wywołaniu konstruktora Regex lub we właściwościach domeny aplikacji nie zdefiniowano limitu czasu lub jeśli wartość limitu czasu jest InfiniteMatchTimeout, nie jest zgłaszany żaden wyjątek.

Zobacz też

• NextMatch()
• Język wyrażeń regularnych — podręczny wykaz

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

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

Parametry

Zwraca

Obiekt zawierający informacje o dopasowaniu.

Wyjątki

Uwagi

Metoda Match(String, Int32) zwraca pierwszy podciąg zgodny ze wzorcem wyrażenia regularnego, zaczynając od lub po pozycji znaku startat w ciągu wejściowym. Wzorzec wyrażenia regularnego, dla którego metoda Match(String, Int32) wyszukuje, jest definiowany przez wywołanie jednego z konstruktorów klasy Regex. Aby uzyskać informacje o elementach języka używanych do tworzenia wzorca wyrażeń regularnych, zobacz Regular Expression Language — Quick Reference.

Parametr startat

Użyj parametru , startat aby określić położenie znaku, w którym rozpoczyna się wyszukiwanie. W wyszukiwaniu od lewej do prawej wszystkie dopasowania rozpoczynające się przed startat ciągiem są ignorowane. Aby rozpocząć od pozycji domyślnej, użyj Match(String) przeciążenia (lub przekaż wartość 0 dla wyszukiwania od lewej do prawej i input.Length wyszukiwania od prawej do lewej). Pomimo uruchomienia wyszukiwania na startatstronie , indeks każdego zwróconego dopasowania jest względny do początku ciągu.

Mimo że aparat wyrażeń regularnych nie zwraca żadnego dopasowania rozpoczynającego się przed startat, to jednak nie ignoruje on ciągu przed startat. Oznacza to, że asercje, takie jak kotwice lub asercje lookbehind , nadal mają zastosowanie do całego wejścia. Na przykład poniższy kod zawiera wzorzec z asercją lookbehind, która jest spełniona, mimo że występuje przed indeksem startat, czyli 5, w ciągu wejściowym.

string input = "Zip code: 98052";
var regex = new Regex(@"(?<=Zip code: )\d{5}");
Match match = regex.Match(input, 5);
if (match.Success)
{
    Console.WriteLine($"Match found: {match.Value}");
}

// This code prints the following output:
//
// Match found: 98052

Wyszukiwania od prawej do lewej

Wyszukiwanie od prawej do lewej, czyli gdy wzorzec wyrażenia regularnego jest skonstruowany z opcją RegexOptions.RightToLeft, zachowuje się w następujący sposób:

• Skan porusza się w przeciwnym kierunku, a wzorzec jest dopasowany z tyłu (po prawej) do przodu (po lewej).
• Domyślna pozycja początkowa to prawy koniec ciągu wejściowego.
• Jeśli określono startat, skanowanie od prawej do lewej rozpoczyna się od znaku startat - 1 (nie startat).
• Gdy kotwica \G jest określona na prawym końcu wzorca, ogranicza dopasowanie (pierwsze) do końca dokładnie na startat - 1.

Aby uzyskać więcej informacji na temat wyszukiwania od prawej do lewej, zobacz tryb od prawej do lewej.

Ustal, czy znaleziono dopasowanie

Można określić, czy wzorzec wyrażenia regularnego został znaleziony w ciągu wejściowym, sprawdzając wartość zwróconej właściwości Match obiektu Success. Jeśli zostanie znalezione dopasowanie, właściwość Match zwróconego obiektu Value zawiera podciąg z input, który pasuje do wzorca wyrażenia regularnego. Jeśli nie zostanie znalezione dopasowanie, jego wartość jest String.Empty.

Pierwsze lub wiele dopasowań

Ta metoda zwraca pierwszy podciąg znaleziony przez skanowanie input rozpoczynające się od startat pozycji (lub w przypadku wyszukiwań od prawej do lewej od startat - 1), które jest zgodne ze wzorcem wyrażenia regularnego. Kolejne dopasowania można pobrać, wielokrotnie wywołując zwracaną metodę Match obiektu Match.NextMatch. Można również pobrać wszystkie dopasowania w jednym wywołaniu, wywołując metodę Regex.Matches(String, Int32).

Wyjątki przekroczenia limitu czasu

Wyjątek RegexMatchTimeoutException jest zgłaszany, jeśli czas wykonywania pasującej operacji przekracza interwał limitu czasu określony przez konstruktora Regex.Regex(String, RegexOptions, TimeSpan). Jeśli nie ustawisz interwału przekroczenia limitu czasu podczas wywoływania konstruktora, wyjątek jest zgłaszany, jeśli operacja przekracza wartość limitu czasu ustanowioną dla domeny aplikacji, w której jest tworzony obiekt Regex. Jeśli w wywołaniu konstruktora Regex lub we właściwościach domeny aplikacji nie zdefiniowano limitu czasu lub jeśli wartość limitu czasu jest Regex.InfiniteMatchTimeout, nie jest zgłaszany żaden wyjątek.

Zobacz też

• NextMatch()
• Język wyrażeń regularnych — podręczny wykaz

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

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

Parametry

Zwraca

Obiekt zawierający informacje o dopasowaniu.

Wyjątki

Uwagi

Metoda statyczna Match(String, String) jest równoważna konstruowaniu Regex obiektu z określonym wzorcem i wywoływaniem metody wystąpienia Match(String) . Aparat wyrażeń regularnych buforuje wzorzec.

Można określić, czy wzorzec wyrażenia regularnego został znaleziony w ciągu wejściowym, sprawdzając właściwość zwróconego MatchSuccess obiektu. Jeśli zostanie znalezione dopasowanie, właściwość zwróconego Match obiektu Value zawiera pasujący podciąg. Jeśli nie zostanie znalezione dopasowanie, jego wartość jest Empty.

Kolejne dopasowania można pobrać, wielokrotnie wywołując zwracaną metodę Match obiektu NextMatch(). Można również pobrać wszystkie dopasowania w jednym wywołaniu, wywołując metodę Matches(String, String).

Notatki dotyczące wywoływania

Ta metoda powoduje przekroczenie limitu czasu po interwale równym domyślnej wartości limitu czasu domeny aplikacji, w której jest wywoływana. Jeśli dla domeny aplikacji nie zdefiniowano wartości limitu czasu, zostanie użyta wartość InfiniteMatchTimeout, która uniemożliwia przekroczenie limitu czasu metody. Zalecaną metodą statyczną pobierania dopasowania wzorca jest Match(String, String), która umożliwia ustawienie interwału limitu czasu.

Zobacz też

• NextMatch()
• Język wyrażeń regularnych — podręczny wykaz

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

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

Parametry

Zwraca

Obiekt zawierający informacje o dopasowaniu.

Wyjątki

Uwagi

Metoda Match(String, Int32, Int32) wyszukuje część zdefiniowaną input przez beginning parametry i length dla wzorca wyrażenia regularnego. beginning zawsze definiuje indeks najbardziej lewego znaku do uwzględnienia w wyszukiwaniu i length definiuje maksymalną liczbę znaków do wyszukania. Razem definiują zakres wyszukiwania. Zachowanie jest dokładnie takie, jakby dane wejściowe były skutecznie input.Substring(beginning, length), z tą różnicą, że indeks każdego dopasowania jest liowany względem początku .input Oznacza to, że wszelkie asercji kotwice lub asercji o zerowej szerokości na początku lub na końcu wzorca zachowują się tak, jakby nie było żadnych danych wejściowych poza tym zakresem.

Jeśli wyszukiwanie będzie kontynuowane od lewej do prawej (wartość domyślna), aparat wyrażeń regularnych wyszukuje znak w indeksie beginning do znaku w indeksie beginning + length — 1. Jeśli aparat wyrażeń regularnych został utworzone przy użyciu RightToLeft opcji , aparat wyszukuje znak w indeksiebeginning + length— 1 do znaku w indeksie .beginning

Ta metoda zwraca pierwsze dopasowanie znalezione w tym zakresie. Kolejne dopasowania można pobrać, wielokrotnie wywołując zwracaną metodę Match obiektu NextMatch().

Zobacz też

• NextMatch()
• Język wyrażeń regularnych — podręczny wykaz

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

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

Parametry

Zwraca

Obiekt zawierający informacje o dopasowaniu.

Wyjątki

Uwagi

Metoda statyczna Match(String, String, RegexOptions) jest równoważna konstruowaniu Regex obiektu za pomocą konstruktora Regex(String, RegexOptions) i wywoływaniu metody wystąpienia Match(String) .

Można określić, czy wzorzec wyrażenia regularnego został znaleziony w ciągu wejściowym, sprawdzając właściwość zwróconego MatchSuccess obiektu. Kolejne dopasowania można pobrać, wielokrotnie wywołując zwracaną metodę Match obiektu NextMatch(). Można również pobrać wszystkie dopasowania w jednym wywołaniu, wywołując metodę Matches(String, String, RegexOptions).

Notatki dotyczące wywoływania

Ta metoda powoduje przekroczenie limitu czasu po interwale równym domyślnej wartości limitu czasu domeny aplikacji, w której jest wywoływana. Jeśli dla domeny aplikacji nie zdefiniowano wartości limitu czasu, zostanie użyta wartość InfiniteMatchTimeout, która uniemożliwia przekroczenie limitu czasu metody. Zalecaną metodą statyczną pobierania dopasowania wzorca jest Match(String, String), która umożliwia ustawienie interwału limitu czasu.

Zobacz też

• NextMatch()
• Język wyrażeń regularnych — podręczny wykaz

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

Regex.Match.cs

Źródło:

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

Parametry

Zwraca

Obiekt zawierający informacje o dopasowaniu.

Wyjątki

Uwagi

Metoda statyczna Match(String, String, RegexOptions, TimeSpan) jest równoważna konstruowaniu Regex obiektu za pomocą konstruktora Regex(String, RegexOptions, TimeSpan) i wywoływaniu metody wystąpienia Match(String) .

Można określić, czy wzorzec wyrażenia regularnego został znaleziony w ciągu wejściowym, sprawdzając właściwość zwróconego MatchSuccess obiektu. Kolejne dopasowania można pobrać, wielokrotnie wywołując zwracaną metodę Match obiektu NextMatch().

Parametr matchTimeout określa, jak długo metoda dopasowania wzorca powinna spróbować znaleźć dopasowanie przed upływem limitu czasu. Ustawienie interwału limitu czasu zapobiega wyrażeniom regularnym, które polegają na nadmiernym wycofywaniu, aby przestać odpowiadać podczas przetwarzania danych wejściowych, które zawierają niemal dopasowania. Jeśli w tym interwale czasu nie znaleziono dopasowania, metoda zgłasza RegexMatchTimeoutException wyjątek. matchTimeout zastępuje dowolną domyślną wartość limitu czasu zdefiniowaną dla domeny aplikacji, w której jest wykonywana metoda.

Notatki dotyczące wywoływania

Zalecamy ustawienie parametru matchTimeout na odpowiednią wartość, na przykład dwie sekundy. Jeśli wyłączysz limity czasu, określając InfiniteMatchTimeoutwartość , aparat wyrażeń regularnych zapewnia nieco lepszą wydajność. Należy jednak wyłączyć limity czasu tylko w następujących warunkach:

• Gdy dane wejściowe przetwarzane przez wyrażenie regularne pochodzą ze znanego i zaufanego źródła lub składa się z tekstu statycznego. Wyklucza to tekst, który został dynamicznie wprowadzany przez użytkowników.

• Gdy wzorzec wyrażenia regularnego został dokładnie przetestowany w celu zapewnienia, że efektywnie obsługuje dopasowania, niezgodne i bliskie dopasowania.

• Gdy wzorzec wyrażenia regularnego nie zawiera żadnych elementów języka, które są znane, aby powodować nadmierne wycofywanie podczas przetwarzania niemal zgodnego.

Zobacz też

• Język wyrażeń regularnych — podręczny wykaz