CKTIS / Python
Treffer eines kompilierten regulären Ausdrucks mit re.Pattern.sub ersetzen
Rufe `sub()` auf einem kompilierten regulären Ausdruck auf, um Treffer durch eine Vorlage oder das Ergebnis einer Funktion zu ersetzen. Mit `count` begrenzt du die Anzahl der Ersetzungen.
Version: Python 3.12
Syntax
pattern = re.compile(regex, flags=0)
pattern.sub(repl, string, count=0)In Python 3.12 ist re.Pattern.sub eine Methode des von re.compile() zurückgegebenen Objekts. Rufe sie als pattern.sub(repl, string, count=0) auf. Anders als die Modulfunktion re.sub() erhält die Methode weder ein separates Muster noch ein Argument flags: Sie verwendet das im Objekt gespeicherte Muster und dessen Flags. Dasselbe Objekt lässt sich für unterschiedliche Eingaben wiederverwenden.
Die Methode ersetzt nicht überlappende Treffer von links nach rechts und gibt das Ergebnis zurück, ohne die Eingabe zu ändern. Gibt es keinen Treffer, bleibt der Rückgabewert gegenüber der Eingabe unverändert. Ein positives count begrenzt die Anzahl der Ersetzungen; 0 oder das Weglassen des Arguments bedeutet kein Limit. Ein leerer Treffer direkt nach einem leeren Treffer wird übersprungen, direkt nach einem nicht leeren Treffer kann er ersetzt werden.
Ein als Zeichenfolge übergebenes repl dient als Vorlage: \g<id> fügt den von der benannten Gruppe id erfassten Text ein, \g<0> den gesamten Treffer. Auch die Schreibweise r"..." schaltet die Verarbeitung der Vorlage nicht ab. So fügt \n einen Zeilenumbruch ein; unbekannte Escape-Sequenzen aus Backslash und ASCII-Buchstabe sind Fehler.
Ist repl eine Funktion, ruft die Methode sie für jeden zu ersetzenden Treffer einmal mit einem re.Match-Objekt auf. Der Rückgabewert wird unverändert eingefügt und nicht als Vorlage interpretiert. Verwende diese Variante, um beliebigen Text wörtlich einzufügen, statt re.escape() dafür einzusetzen: Das ist für Muster gedacht. Mische bei Muster, Eingabe und Ersatzwert nicht str und bytes; das gilt auch für den Rückgabewert der Funktion.
Beispiele
import re
pattern = re.compile(r"sku=(?P<id>[0-9]+)", re.IGNORECASE)
text = "sku=7, SKU=42"
def format_item(match):
return f"item-{int(match.group('id')):04d}"
print(pattern.sub(r"item-\g<id>", text, count=1))
print(pattern.sub(format_item, text))Ergebnis
item-7, SKU=42 item-0007, item-0042
Beide Aufrufe verwenden dasselbe Muster mit `re.IGNORECASE`. Die Vorlage mit `count=1` ändert nur `sku=7`. Der zweite Aufruf geht erneut vom Originaltext aus und füllt beide IDs mit Nullen auf vier Stellen auf.
Zugehörige Lektionen
- Python · Lektion 34 · Fortgeschritten · Version: 5