CKTIS / Python
re.Pattern.fullmatch : vérifier une correspondance intégrale
Cette méthode d’une expression régulière compilée vérifie si le motif couvre toute la chaîne ou toute la plage délimitée par `pos` et `endpos`.
Version : Python 3.12
Syntaxe
compiled.fullmatch(string[, pos[, endpos]]) -> re.Match | Nonere.Pattern.fullmatch est une méthode de l’objet renvoyé par re.compile(). Sans bornes explicites, le motif doit couvrir toute la chaîne. La méthode renvoie un objet re.Match en cas de correspondance, et None sinon. Une correspondance de longueur nulle reste une correspondance : utilisez result is not None pour vérifier que la méthode a réussi.
L’indice facultatif pos fixe le début (0 par défaut), et endpos fixe la fin, exclue de la plage (len(string) par défaut). La correspondance doit couvrir toute cette plage. Dans CPython 3.12, les deux indices sont ramenés dans l’intervalle de 0 à len(string), bornes comprises. Si, après cet ajustement, endpos est inférieur à pos, il n’y a pas de correspondance. Si les deux valeurs obtenues sont égales, une correspondance de longueur nulle est possible. span() renvoie des indices dans la chaîne d’origine. Fixer des bornes ne revient pas à extraire une sous-chaîne : par exemple, ^ ne considère pas pos comme un nouveau début de chaîne.
Utilisez Pattern.match() si une correspondance au début de la plage suffit, ou Pattern.search() pour en trouver une n’importe où dans la plage. La fonction du module re.fullmatch(pattern, string, flags=0) reçoit le motif en argument, mais ne propose ni pos ni endpos. La méthode utilise le motif déjà compilé et ses options ; elle n’accepte pas d’argument flags.
Exemples
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())Résultat
True False (1, 6)
Le motif exige deux lettres majuscules ASCII, un trait d’union et deux chiffres ASCII. `AB-42` correspond, mais pas `AB-42!`. Dans `[AB-42]`, la plage de `1` inclus à `6` exclu laisse de côté les deux crochets ; `span()` renvoie donc `(1, 6)`.
Leçons associées
- Python · Leçon 29 · Intermédiaire · Version : 3