CKTIS / Python
Remplacer les correspondances d’une expression régulière compilée avec re.Pattern.sub
Appelez `sub()` sur une expression régulière compilée pour remplacer les correspondances par un modèle ou par le résultat d’une fonction. `count` limite le nombre de remplacements.
Version : Python 3.12
Syntaxe
pattern = re.compile(regex, flags=0)
pattern.sub(repl, string, count=0)Dans Python 3.12, re.Pattern.sub est une méthode de l’objet renvoyé par re.compile(). Elle s’appelle sous la forme pattern.sub(repl, string, count=0). Contrairement à la fonction de module re.sub(), cette méthode ne prend ni motif séparé ni argument flags : elle utilise le motif et les options déjà stockés dans l’objet. Le même objet peut servir pour différentes entrées.
La méthode remplace les correspondances sans chevauchement, de gauche à droite, et renvoie le résultat sans modifier l’entrée. Si rien ne correspond, elle renvoie l’entrée inchangée. Une valeur positive de count fixe le nombre maximal de remplacements ; avec 0 ou sans cet argument, il n’y a pas de limite. Une correspondance vide est ignorée si elle suit immédiatement une autre correspondance vide, mais elle peut être remplacée juste après une correspondance non vide.
Si repl est une chaîne, celle-ci sert de modèle : \g<id> insère le texte capturé par le groupe nommé id, et \g<0> insère la correspondance entière. Même la notation r"..." ne désactive pas l’interprétation du modèle. Ainsi, \n insère un saut de ligne et une séquence d’échappement inconnue formée d’une barre oblique inverse suivie d’une lettre ASCII provoque une erreur.
Si repl est une fonction, la méthode l’appelle une fois par correspondance à remplacer, avec un objet re.Match. La valeur renvoyée est insérée telle quelle, sans interprétation comme modèle. Utilisez cette forme pour insérer du texte arbitraire à la lettre, plutôt que re.escape(), qui sert aux motifs. Ne mélangez pas str et bytes entre le motif, l’entrée et la valeur de remplacement, même si cette dernière provient de la fonction.
Exemples
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))Résultat
item-7, SKU=42 item-0007, item-0042
Les deux appels réutilisent le même motif avec `re.IGNORECASE`. Le modèle avec `count=1` ne modifie que `sku=7`. Le second appel repart du texte d’origine et complète les deux identifiants avec des zéros pour obtenir quatre chiffres.
Leçons associées
- Python · Leçon 34 · Avancé · Version : 5