WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

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

Quellen