CKTIS / Python
Zastępowanie dopasowań skompilowanego wzorca za pomocą re.Pattern.sub
Wywołaj `sub()` na skompilowanym wzorcu, aby zastąpić dopasowania szablonem lub wynikiem funkcji. Użyj `count`, aby ograniczyć liczbę zamian.
Wersja: Python 3.12
Składnia
pattern = re.compile(regex, flags=0)
pattern.sub(repl, string, count=0)W Pythonie 3.12 re.Pattern.sub jest metodą obiektu zwracanego przez re.compile(). Wywołaj pattern.sub(repl, string, count=0). W przeciwieństwie do funkcji modułu re.sub() metoda nie przyjmuje osobnego wzorca ani argumentu flags: używa wzorca i flag zapisanych w obiekcie. Tego samego obiektu można używać z różnymi danymi wejściowymi.
Metoda zwraca wynik zastępowania kolejnych, nienakładających się dopasowań od lewej do prawej. Nie modyfikuje wejścia, a jeśli nie ma dopasowania, zwraca jego niezmienioną wartość. Dodatnie count określa maksymalną liczbę zamian; 0 lub pominięcie argumentu oznacza brak limitu. Puste dopasowanie bezpośrednio po poprzednim pustym dopasowaniu nie podlega zamianie, ale może zostać zastąpione bezpośrednio po niepustym dopasowaniu.
Jeśli repl jest ciągiem, działa jak szablon: \g<id> wstawia zawartość nazwanej grupy id, a \g<0> wstawia całe dopasowanie. Nawet zapis r"..." nie wyłącza interpretacji szablonu. Na przykład \n wstawia znak nowego wiersza, a nieznane sekwencje z ukośnikiem odwrotnym i literą ASCII powodują błąd.
Jeśli repl jest funkcją, metoda wywołuje ją raz dla każdego zastępowanego dopasowania, przekazując jeden obiekt re.Match. Wynik funkcji jest wstawiany dosłownie, bez interpretacji jako szablon. Użyj tego wariantu, aby wstawić dowolny tekst dosłownie, zamiast stosować re.escape(), które służy do przygotowywania wzorców. Nie mieszaj str i bytes we wzorcu, wejściu ani wartości zastępującej, także gdy zwraca ją funkcja.
Przykłady
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))Wynik
item-7, SKU=42 item-0007, item-0042
Oba wywołania korzystają z tego samego wzorca z flagą `re.IGNORECASE`. Szablon z `count=1` zmienia tylko `sku=7`. Drugie wywołanie ponownie używa oryginalnego tekstu i uzupełnia oba identyfikatory zerami do czterech cyfr.
Powiązane lekcje
- Python · Lekcja 34 · Zaawansowany · Wersja: 5