Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

re.Match.group — pobieranie dopasowanych grup

Metoda re.Match.group pobiera całe dopasowanie lub wybrane grupy przechwytujące według numeru albo nazwy.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

match.group([group1, ...])

re.Match.group działa na obiekcie dopasowania. Najpierw sprawdź, czy wyszukiwanie nie zwróciło None. match.group() i match.group(0) zwracają całe dopasowanie, niekoniecznie cały tekst wejściowy.

Grupy przechwytujące są numerowane od 1, według kolejności nawiasów otwierających. Grupę (?P<name>...) można wskazać nazwą lub numerem. Jeden argument wybiera jedną wartość; wiele argumentów zwraca krotkę w podanej kolejności. Dopasowane wartości mają typ str albo bytes, zależnie od wejścia.

Grupa, która nie uczestniczyła w dopasowaniu, daje None, a dopasowana pusta grupa daje pusty ciąg. Przy powtarzaniu grupy dostępne jest tylko ostatnie przechwycenie. Ujemny lub zbyt duży numer oraz nieznana nazwa powodują IndexError.

Przykłady

import re

match = re.fullmatch(r"(?P<item>[a-z]+)(?:-([0-9]+))?", "book")
if match is None:
    raise ValueError("No match")

print(match.group())
print(match.group("item"))
print(match.group(1, 2))

Wynik

book
book
('book', None)

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła