Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

re.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

Sources