Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 | None

re.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

Zdroje