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

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

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

Zdroje