Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

re.Pattern.fullmatch: dopasowanie całego łańcucha

Metoda skompilowanego wyrażenia regularnego sprawdza, czy wzorzec pasuje do całego łańcucha lub całego zakresu wyznaczonego przez indeksy `pos` i `endpos`.

Wersja: Python 3.12

Składnia

compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.fullmatch to metoda obiektu zwracanego przez re.compile(). Bez podania granic wzorzec musi objąć cały łańcuch. Metoda zwraca obiekt re.Match w razie dopasowania, a None w razie jego braku. Dopasowanie o długości zero nadal jest dopasowaniem; aby sprawdzić, czy się powiodło, użyj result is not None.

Opcjonalny indeks pos wyznacza początek zakresu (domyślnie 0), a endpos jego koniec, który nie należy do zakresu (domyślnie len(string)). Dopasowanie musi objąć cały ten zakres. W CPythonie 3.12 wartości obu indeksów są ograniczane do przedziału od 0 do len(string) włącznie. Jeśli po tym ograniczeniu endpos jest mniejsze niż pos, nie ma dopasowania. Jeśli wartości są równe, możliwe jest dopasowanie o długości zero. span() podaje indeksy w oryginalnym łańcuchu. Podanie granic nie jest tym samym co wycięcie fragmentu: na przykład ^ nie traktuje pos jako nowego początku łańcucha.

Użyj Pattern.match(), jeśli wystarczy dopasowanie na początku zakresu, albo Pattern.search(), jeśli chcesz znaleźć dopasowanie w dowolnym miejscu zakresu. Funkcja modułowa re.fullmatch(pattern, string, flags=0) przyjmuje wzorzec jako argument, ale nie udostępnia pos ani endpos. Metoda korzysta z już skompilowanego wzorca i jego flag; nie przyjmuje argumentu flags.

Przykłady

import re

code_pattern = re.compile(r"[A-Z]{2}-[0-9]{2}")

print(code_pattern.fullmatch("AB-42") is not None)
print(code_pattern.fullmatch("AB-42!") is not None)

match = code_pattern.fullmatch("[AB-42]", 1, 6)
assert match is not None
print(match.span())

Wynik

True
False
(1, 6)

Wzorzec wymaga dwóch wielkich liter ASCII, łącznika i dwóch cyfr ASCII. `AB-42` pasuje, a `AB-42!` nie. W `[AB-42]` zakres od `1` włącznie do `6` wyłącznie pomija oba nawiasy kwadratowe, więc `span()` zwraca `(1, 6)`.

Powiązane lekcje

  • Python · Lekcja 29 · Średniozaawansowany · Wersja: 3

Źródła