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

CKTIS / Python

re.Pattern.search : trouver la première correspondance avec un motif compilé

Utilise une expression régulière compilée pour trouver la première correspondance dans une chaîne ou dans une zone délimitée par des indices.

Version : Python 3.12

Syntaxe

pattern = re.compile(expression, flags=0)
pattern.search(string[, pos[, endpos]]) -> re.Match | None

re.Pattern.search est une méthode de l’objet renvoyé par re.compile(). L’appel pattern.search(string) renvoie un objet re.Match pour la première position où le motif correspond, même au milieu de la chaîne. À l’inverse, pattern.match() ne fait un essai qu’à la position de départ et pattern.fullmatch() exige que toute la zone spécifiée corresponde.

L’indice facultatif pos indique où commence la recherche et vaut 0 par défaut. endpos est la borne supérieure exclue et vaut par défaut la longueur de la chaîne. Dans CPython 3.12, les valeurs de pos et endpos sont ramenées, si nécessaire, dans l’intervalle allant de 0 à la longueur de la chaîne, bornes incluses. Si endpos < pos après cet ajustement, la méthode renvoie None. Indiquer pos ne revient pas à découper la chaîne : l’ancre ^ ne considère pas pos comme un nouveau début de chaîne.

Teste match is not None avant de lire le résultat. Une correspondance de longueur nulle est tout de même un objet re.Match. match.group(0) renvoie toute la sous-chaîne correspondante et match.span() renvoie ses indices (début, fin) dans la chaîne d’origine, l’indice de fin étant exclu.

La fonction de module re.search(pattern, string, flags=0) reçoit le motif en argument et ne possède ni paramètre pos ni paramètre endpos. La méthode utilise le motif déjà stocké dans l’objet compilé, que tu peux réutiliser. Passe les options en argument à re.compile(), pas à pattern.search().

Exemples

import re

pattern = re.compile(r"[A-Z][0-9]{2}")
text = "IDs: A17, B42"

for match in (pattern.search(text), pattern.search(text, pos=8)):
    if match is not None:
        print(match.group(0), match.span())

print(pattern.search(text, pos=8, endpos=12))

Résultat

A17 (5, 8)
B42 (10, 13)
None

Le motif reconnaît une lettre majuscule ASCII suivie de deux chiffres ASCII. Le premier appel trouve `A17` ; avec `pos=8`, la recherche l’ignore et trouve `B42`. Avec `endpos=12`, le dernier chiffre `2` est hors de la zone de recherche, donc le résultat est `None`.

Leçons associées

  • Python · Leçon 30 · Intermédiaire · Version : 3

Sources