KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Overeenkomsten van een gecompileerde reguliere expressie vervangen met re.Pattern.sub

Roep `sub()` aan op een gecompileerde reguliere expressie om overeenkomsten te vervangen door een sjabloon of het resultaat van een functie. Met `count` beperk je het aantal vervangingen.

Versie: Python 3.12

Syntax

pattern = re.compile(regex, flags=0)
pattern.sub(repl, string, count=0)

In Python 3.12 is re.Pattern.sub een methode van het object dat re.compile() teruggeeft. Roep de methode aan als pattern.sub(repl, string, count=0). Anders dan de modulefunctie re.sub() krijgt de methode geen apart patroon en geen argument flags: ze gebruikt het patroon en de vlaggen die al in het object staan. Je kunt hetzelfde object met verschillende invoerwaarden gebruiken.

De methode vervangt niet-overlappende overeenkomsten van links naar rechts en geeft het resultaat terug zonder de invoer te wijzigen. Als niets overeenkomt, geeft ze de invoer ongewijzigd terug. Een positieve count stelt het maximumaantal vervangingen in; met 0 of zonder dit argument is er geen limiet. Een lege overeenkomst wordt overgeslagen als die direct op een andere lege overeenkomst volgt, maar kan direct na een niet-lege overeenkomst wel worden vervangen.

Als repl een tekenreeks is, dient die als sjabloon: \g<id> voegt de tekst uit de benoemde groep id in en \g<0> voegt de hele overeenkomst in. Ook met de notatie r"..." wordt het sjabloon nog geïnterpreteerd. Zo voegt \n een regeleinde in en leidt een onbekende escapereeks van een backslash gevolgd door een ASCII-letter tot een fout.

Als repl een functie is, roept de methode die één keer aan per te vervangen overeenkomst, met één re.Match-object. De retourwaarde wordt letterlijk ingevoegd, zonder die als sjabloon te interpreteren. Gebruik deze vorm om willekeurige tekst letterlijk in te voegen, niet re.escape(): dat is bedoeld voor patronen. Meng str en bytes niet in het patroon, de invoer en de vervangingswaarde, ook niet als de functie die waarde teruggeeft.

Voorbeelden

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

Resultaat

item-7, SKU=42
item-0007, item-0042

Beide aanroepen hergebruiken hetzelfde patroon met `re.IGNORECASE`. Het sjabloon met `count=1` verandert alleen `sku=7`. De tweede aanroep begint opnieuw met de oorspronkelijke tekst en vult beide ID’s met voorloopnullen aan tot vier cijfers.

Gerelateerde lessen

  • Python · Les 34 · Gevorderd · Versie: 5

Bronnen