CKTIS / Python
re.Pattern.fullmatch: shoda s celým řetězcem
Tato metoda zkompilovaného regulárního výrazu ověří, zda vzor odpovídá celému řetězci nebo celému rozsahu vymezenému indexy `pos` a `endpos`.
Verze: Python 3.12
Syntaxe
compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.fullmatch je metoda objektu, který vrací re.compile(). Bez zadaných hranic musí vzor pokrýt celý řetězec. Při shodě metoda vrátí objekt re.Match, jinak None. I shoda nulové délky se počítá; existenci shody ověř pomocí result is not None.
Volitelný index pos určuje začátek (výchozí hodnota 0) a endpos konec, který do rozsahu nepatří (výchozí hodnota len(string)). Shoda musí pokrývat celý tento rozsah. V CPythonu 3.12 jsou oba indexy omezeny na interval od 0 do len(string) včetně. Pokud je po tomto omezení endpos menší než pos, shoda nenastane. Pokud se výsledné hodnoty rovnají, je možná shoda nulové délky. span() vrací indexy v původním řetězci. Nastavení hranic není totéž co vytvoření podřetězce: například ^ nepovažuje pos za nový začátek řetězce.
Použij Pattern.match(), pokud stačí shoda na začátku rozsahu, nebo Pattern.search(), pokud hledáš shodu kdekoli v rozsahu. Funkce modulu re.fullmatch(pattern, string, flags=0) přijímá vzor jako argument, ale nenabízí pos ani endpos. Metoda používá již zkompilovaný vzor a jeho příznaky; argument flags nepřijímá.
Příklady
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())Výsledek
True False (1, 6)
Vzor vyžaduje dvě velká písmena ASCII, spojovník a dvě číslice ASCII. `AB-42` vzoru odpovídá, ale `AB-42!` ne. V řetězci `[AB-42]` rozsah od `1` včetně do `6` bez tohoto koncového indexu vynechává obě hranaté závorky, takže `span()` vrátí `(1, 6)`.
Související lekce
- Python · Lekce 29 · Středně pokročilá · Verze: 3