4.2.4 Les Objets Expression Régulière

Les objets expressions régulières compilées supportent les méthodes et les attributs suivant :

RegexObjectsearch(string[, pos[, endpos]])

Scanne string à la recherche d'un emplacement où se trouve cette expression régulière, et renvoie une instance MatchObject. Renvoie None si auncune position dans la chaîne de caractères ne correspond au motif ; notez que ce n'est pas la même chose que de trouver une correspondance de taille zéro à un certain point de la chaîne de caractères. Les paramètres optionnels pos et endpos ont la même signification que pour la méthode match().

RegexObjectmatch(string[, pos[, endpos]])

Si zéro caractères ou plus au début de string correspondent à l'expression régulière, renvoie une instance MatchObject. Renvoie None si la chaîne de caractères ne correspond pas au motif ; notez que ce n'est pas la même chose qu'une correspondance de taille zéro.

Note: Si vous voulez localiser une correspondance n'importe où dans string, utilisez search() à la place.

Le deuxième paramètre optionnel pos donne un index dans la chaîne de caractères où la recherche doit commencer ; il vaut par défaut 0. Ce n'est pas complètement équivalent à découper la chaîne de caractères en tranches ; le caractère de motif '^' correspond au vrai début de la chaîne de caractères et aux positions juste aprés un saut de ligne, mais pas nécessairement à l'index où la recherche commence.

Le paramètre optionnel endpos limite à quelle distance la chaîne de caractères sera recherchée ; c'est comme si la chaîne de caractères est longue de endpos caractères, ainsi seulement les caractères de pos à endpos sera recherché pour une correspondance.

RegexObjectsplit(string[, maxsplit = 0])

Identique à la fonction split(), en utilisant les motifs compilés.

RegexObjectfindall(string)

Identique à la fonction findall(), en utilisant les motifs compilés.

RegexObjectsub(repl, string[, count = 0])

Identique à la fonction sub(), en utilisant les motifs compilés.

RegexObjectsubn(repl, string[, count = 0])

Identique à la fonction subn(), en utilisant les motifs compilés.

RegexObjectflags

Les indicateurs utilisés quand l'objet regex a été compilé, ou 0 si aucun indicateur n'était fournis.

RegexObjectgroupindex

Un dictionnaire traçant tous les groupes de noms symboliques définis par (?P<id>) aux nombres de groupe. Le dictionnaire est vide si aucun groupe symbolique n'était utilisé dans les motifs.

RegexObjectmotif

La chaîne de caractères motif dont l'objet regex a été compilé.