CKTIS / Python
re.Pattern.fullmatch: Die gesamte Zeichenkette abgleichen
Mit dieser Methode eines kompilierten regulären Ausdrucks prüfst du, ob das Muster zur gesamten Zeichenkette oder zum gesamten durch `pos` und `endpos` gewählten Bereich passt.
Version: Python 3.12
Syntax
compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.fullmatch ist eine Methode des Objekts, das re.compile() zurückgibt. Ohne Bereichsgrenzen muss das Muster die gesamte Zeichenkette abdecken. Bei Erfolg liefert die Methode ein re.Match-Objekt, sonst None. Auch ein Treffer der Länge null zählt als Treffer; prüfe mit result is not None, ob die Suche erfolgreich war.
Der optionale Index pos legt den Anfang fest (Standard: 0), endpos das exklusive Ende (Standard: len(string)). Der Treffer muss den ganzen Bereich abdecken. In CPython 3.12 werden beide Indizes auf das Intervall von 0 bis einschließlich len(string) begrenzt. Ist endpos danach kleiner als pos, gibt es keinen Treffer. Sind die begrenzten Werte gleich, ist ein Treffer der Länge null möglich. span() liefert Indizes in der ursprünglichen Zeichenkette. Bereichsgrenzen sind nicht dasselbe wie ein Slice: ^ behandelt pos beispielsweise nicht als neuen Anfang der Zeichenkette.
Verwende Pattern.match(), wenn ein Treffer am Anfang des Bereichs genügt, oder Pattern.search(), wenn du an beliebiger Stelle im Bereich nach einem Treffer suchst. Die Modulfunktion re.fullmatch(pattern, string, flags=0) nimmt das Muster als Argument entgegen, bietet aber weder pos noch endpos. Die Methode verwendet das bereits kompilierte Muster und dessen Flags; sie hat kein flags-Argument.
Beispiele
import re
code_pattern = re.compile(r"[A-Z]{2}-[0-9]{2}")
print(code_pattern.fullmatch("AB-42") is not None)
print(code_pattern.fullmatch("AB-42!") is not None)
match = code_pattern.fullmatch("[AB-42]", 1, 6)
assert match is not None
print(match.span())Ergebnis
True False (1, 6)
Das Muster verlangt zwei ASCII-Großbuchstaben, einen Bindestrich und zwei ASCII-Ziffern. `AB-42` passt, `AB-42!` dagegen nicht. In `[AB-42]` schließt der Bereich von `1` einschließlich bis `6` ausschließlich beide eckigen Klammern aus. Daher gibt `span()` den Wert `(1, 6)` zurück.
Zugehörige Lektionen
- Python · Lektion 29 · Mittlere Stufe · Version: 3