CKTIS / Python
re.Pattern.search: první shoda se zkompilovaným vzorem
Pomocí zkompilovaného regulárního výrazu najdeš první shodu v celém řetězci nebo v rozsahu vymezeném počátečním a koncovým indexem.
Verze: Python 3.12
Syntaxe
pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.search je metoda objektu, který vrací re.compile(). Volání pattern.search(string) vrací objekt re.Match pro první pozici, na které vzor odpovídá, třeba i uprostřed řetězce. Naproti tomu pattern.match() zkouší shodu jen na počáteční pozici a pattern.fullmatch() vyžaduje shodu v celém zadaném rozsahu.
Volitelný index pos určuje začátek hledání a má výchozí hodnotu 0. endpos je horní hranice, která se do rozsahu nezapočítává a ve výchozím nastavení se rovná délce řetězce. V CPythonu 3.12 se hodnoty pos a endpos omezí na interval od 0 do délky řetězce včetně obou mezí. Pokud po tomto omezení platí endpos < pos, metoda vrátí None. Nastavení pos není totéž jako výřez řetězce: kotva ^ nepovažuje pos za nový začátek řetězce.
Než budeš číst výsledek, ověř match is not None. I shoda nulové délky je objekt re.Match. match.group(0) vrací celý odpovídající podřetězec a match.span() vrací dvojici indexů (začátek, konec) v původním řetězci, přičemž koncový index do shody nepatří.
Funkce modulu re.search(pattern, string, flags=0) přijímá vzor jako argument a nemá parametry pos ani endpos. Metoda používá vzor uložený ve zkompilovaném objektu, který lze používat opakovaně. Příznaky předávej jako argumenty funkci re.compile(), ne metodě pattern.search().
Příklady
import re
pattern = re.compile(r"[A-Z][0-9]{2}")
text = "IDs: A17, B42"
for match in (pattern.search(text), pattern.search(text, pos=8)):
if match is not None:
print(match.group(0), match.span())
print(pattern.search(text, pos=8, endpos=12))Výsledek
A17 (5, 8) B42 (10, 13) None
Vzor odpovídá jednomu velkému písmenu ASCII následovanému dvěma číslicemi ASCII. První volání najde `A17`; při `pos=8` ho hledání přeskočí a najde `B42`. Při `endpos=12` je poslední `2` mimo rozsah hledání, takže výsledkem je `None`.
Související lekce
- Python · Lekce 30 · Středně pokročilá · Verze: 3