Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła