Compilation d'expressions rationnelles POSIX¶

regcomp() est utilisée pour compiler une expression rationnelle sous une forme utilisable par la suite pour des recherches avec regexec().

On fournit à regcomp() les arguments preg, un pointeur vers un tampon de stockage du motif, regex, un pointeur vers une chaîne terminée par un caractère NULL, et cflags, les attributs indiquant le type de compilation.

Toutes les recherches d'expressions rationnelles sont effectuées au moyen d'un tampon de motif compilé, ainsi regexec() doit toujours recevoir l'adresse d'un motif initialisé par regcomp().

cflags est le OU binaire entre une ou plusieurs constantes symboliques suivantes :

REG_EXTENDED

Utiliser la syntaxe d'expression rationnelle étendue POSIX pour interpréter regex. Sinon, la syntaxe d'expression rationnelle de base POSIX est utilisée.

REG_ICASE

Ne pas différencier les majuscules des minuscules. Les recherches regexec() suivantes utilisant le tampon de motif n'effectueront pas la différenciation.

REG_NOSUB

Ne pas signaler la position des correspondances de chaînes. Les paramètres nmatch et pmatch de regexec() ne sont pas pris en compte si le tampon de motif est compilé avec cet attribut.

REG_NEWLINE

Les opérateurs «\ n'importe-quel-caractère\ » ne s'identifient pas à un saut de ligne.

Une liste d'exceptions ([^...]) ne contenant pas de saut de ligne ne s'identifie pas à un saut de ligne.

L'opérateur «\ début-de-ligne\ » (^) s'identifie à la chaîne vide immédiatement après un saut de ligne, même si l'attribut eflags de regexec() contient REG_NOTBOL.

L'opérateur «\ fin-de-ligne\ » ($) s'identifie à la chaîne vide précédant immédiatement un saut de ligne, même si l'attribut eflags contient REG_NOTEOL.

Correspondance d'expressions rationnelles POSIX¶

regexec() est utilisée pour mettre en correspondance une chaîne terminée par un caractère NULL, avec le tampon de motif précompilé preg. nmatch et pmatch fournissent des informations concernant l'emplacement des correspondances. eflags est un OU binaire entre zéro ou plusieurs des drapeaux suivants :

REG_NOTBOL

L'opérateur «\ début-de-ligne\ » échoue toujours (mais voyez l'attribut de compilation REG_NEWLINE ci-dessus). Cet attribut peut être utilisé quand différentes portions d'une chaîne sont transmises à regexec() et que le début de la chaîne ne peut pas être interprété comme un début de ligne.

REG_NOTEOL

L'opérateur «\ fin-de-ligne\ » échoue toujours (mais voyez l'attribut de compilation REG_NEWLINE ci-dessus).

REG_TARTEND

Utiliser pmatch[0] sur la chaîne en entrée commençant à l'octet pmatch[0].rm_so et finissant avant l'octet pmatch[0].rm_eo. Cela permet de faire correspondre les octets de valeur NULL intégrés et évite un strlen(3) sur de grandes chaînes. Cela n'utilise pas nmatch en entrée et ne change pas le traitement de REG_NEWLINE ou REG_NOTBOL. Ce drapeau est une extension BSD et n'est pas présent dans POSIX.

Décalage d'octets¶

À moins que l'attribut REG_NOSUB n'ait été utilisé lors de la compilation du motif, il est possible d'obtenir des informations sur les correspondances de chaînes. pmatch doit être dimensionnée pour contenir au moins nmatch éléments. Ils sont remplis par regexec() avec les adresses des sous-chaînes mises en correspondance. Les positions de la sous-expression débutant à la ième parenthèse sont stockées dans pmatch[i]. Les adresses de mise en correspondance de l'expression complète sont stockées dans pmatch[0]. (Remarquez que pour obtenir les positions de correspondance de la sous-expression N, nmatch doit valoir au moins N+1.) Tous les éléments de structure inutilisés contiendront la valeur -1.

La structure regmatch_t du type pmatch est définie dans <regex.h>.

typedef struct {


    regoff_t rm_so;


    regoff_t rm_eo;
} regmatch_t;

Chaque élément rm_so différent de -1 indique le point de départ de la sous-chaîne suivante la plus longue qui soit mise en correspondance. L'élément rm_eo indique le décalage de la fin de la sous-chaîne, qui est l'emplacement du premier caractère après le texte qui correspond.

Retours d'erreurs POSIX¶

regerror() est utilisé pour transformer les codes d'erreur renvoyés par regcomp() et par regexec() en libellés.

regerror() reçoit le code errcode, le tampon de motif preg, un pointeur sur une chaîne de caractères errbuf, et la longueur maximale de cette chaîne errbuf_size. Cette fonction renvoie la taille errbuf nécessaire pour contenir le libellé d'erreur terminé par un caractère NULL. Si errbuf et errbuf_size ne sont pas nuls, errbuf est rempli avec les errbuf_size - 1 premiers caractères du libellé d'erreur, suivis d'un caractère NULL de terminaison (« \0 »).

Libération des tampons de motifs POSIX¶

En fournissant à regfree() un tampon de motif précompilé preg, il libérera la mémoire allouée au tampon durant la compilation avec regcomp().