CKTIS / Python
re.Match.group — übereinstimmende Gruppen abrufen
Die Methode re.Match.group gibt die gesamte Übereinstimmung oder ausgewählte Erfassungsgruppen anhand ihrer Nummer oder ihres Namens zurück.
Version: Python 3.14; repository image, production runtime not attested
Syntax
match.group([group1, ...])re.Match.group wird auf einem Match-Objekt aufgerufen. Prüfe zuerst, ob der Suchvorgang nicht None zurückgegeben hat. match.group() und match.group(0) geben die gesamte Übereinstimmung zurück, die nicht unbedingt der gesamte Eingabetext ist.
Erfassungsgruppen werden ab 1 in der Reihenfolge ihrer öffnenden Klammern nummeriert. Eine Gruppe (?P<name>...) kann über ihren Namen oder ihre Nummer ausgewählt werden. Ein Argument wählt einen Wert aus; mehrere Argumente geben ein Tupel in der angeforderten Reihenfolge zurück. Die übereinstimmenden Werte sind je nach Eingabe str oder bytes.
Eine Gruppe, die nicht an der Übereinstimmung beteiligt war, ergibt None; eine Gruppe, die mit einer leeren Zeichenfolge übereinstimmt, ergibt dagegen eine leere Zeichenfolge. Bei einer wiederholten Gruppe ist nur die letzte Erfassung verfügbar. Eine negative oder außerhalb des gültigen Bereichs liegende Nummer sowie ein unbekannter Name lösen IndexError aus.
Beispiele
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))Ergebnis
book
book
('book', None)Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.