CKTIS / Python
re.Pattern.search: pierwsze dopasowanie skompilowanego wzorca
Użyj skompilowanego wyrażenia regularnego, aby znaleźć pierwsze dopasowanie w całym ciągu lub w zakresie wyznaczonym przez indeksy.
Wersja: Python 3.12
Składnia
pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.search to metoda obiektu zwracanego przez re.compile(). Wywołanie pattern.search(string) zwraca obiekt re.Match dla pierwszej pozycji, w której wzorzec pasuje, także w środku ciągu. Natomiast pattern.match() sprawdza dopasowanie tylko od pozycji początkowej, a pattern.fullmatch() wymaga dopasowania całego wskazanego zakresu.
Opcjonalny indeks pos wyznacza miejsce rozpoczęcia wyszukiwania i domyślnie wynosi 0. endpos to wyłączna granica końcowa, domyślnie równa długości ciągu. W CPythonie 3.12 wartości pos i endpos są ograniczane do przedziału od 0 do długości ciągu włącznie. Jeśli po tym ograniczeniu endpos < pos, metoda zwraca None. Ustawienie pos nie jest równoważne wycięciu fragmentu: kotwica ^ nie zaczyna oznaczać początku w miejscu wskazanym przez pos.
Sprawdź match is not None, zanim odczytasz wynik. Dopasowanie o zerowej długości nadal jest obiektem re.Match. match.group(0) zwraca cały dopasowany fragment, a match.span() zwraca parę (początek, koniec) z indeksami względem oryginalnego ciągu; indeks końcowy jest wyłączny.
Funkcja modułowa re.search(pattern, string, flags=0) przyjmuje wzorzec jako argument i nie ma parametrów pos ani endpos. W metodzie wzorzec jest już częścią obiektu: możesz go używać wielokrotnie, a flagi przekazywane jako argument ustawiasz w re.compile(), nie w pattern.search().
Przykłady
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))Wynik
A17 (5, 8) B42 (10, 13) None
Wzorzec dopasowuje wielką literę ASCII, po której występują dwie cyfry ASCII. Pierwsze wywołanie znajduje `A17`, a `pos=8` pomija je i pozwala znaleźć `B42`. Przy `endpos=12` ostatnia cyfra `2` jest poza zakresem, więc wynik to `None`.
Powiązane lekcje
- Python · Lekcja 30 · Średniozaawansowany · Wersja: 3