Compilation d'expressions rationnelles POSIX¶

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

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

cflags may be the bitwise-or of zero or more of the following:

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

L'opérateur «\ n'importe-quel-caractère\ » ne s'identifie pas avec le saut de ligne.

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

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

L'opérateur «\ fin-de-ligne\ » ($) s'identifie avec une 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¶

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 correspond pas à 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_STARTEND

Use pmatch[0] on the input string, starting at byte pmatch[0].rm_so and ending before byte pmatch[0].rm_eo. This allows matching embedded NUL bytes and avoids a strlen(3) on large strings. It does not use nmatch on input, and does not change REG_NOTBOL or REG_NEWLINE processing. This flag is a BSD extension, not present in POSIX.

Décalage d'octets¶

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() 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 nul. Si errbuf et errbuf_size son non nuls, errbuf est rempli avec les errbuf_size - 1 premiers caractères du libellé d'erreur, suivis d'un caractère nul de terminaison (« \0 »).

Libération des tampons de motifs POSIX¶