NOM¶

regcomp, regexec, regerror, regfree – Fonctions POSIX pour les expressions rationnelles (« regex »)

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <regex.h>

int regcomp(regex_t *restrict preg, const char *restrict regex,
            int cflags);
int regexec(const regex_t *restrict preg, const char *restrict chaîne,
            size_t nmatch, regmatch_t pmatch[_Nullable restrict .nmatch],
            int eflags);

size_t regerror(int errcode, const regex_t *_Nullable restrict preg,
            char errbuf[_Nullable restrict .errbuf_size],
            size_t errbuf_size);
void regfree(regex_t *preg);

typedef struct {
size_t    re_nsub;
} regex_t;

typedef struct {
regoff_t  rm_so;
regoff_t  rm_eo;
} regmatch_t;

typedef /* ... */  regoff_t;

DESCRIPTION¶

VALEUR RENVOYÉE¶

regcomp() renvoie zéro si la compilation réussit, ou un code d'erreur en cas d'échec.

regexec() renvoie zéro si la correspondance réussit ou REG_NOMATCH si elle échoue.

regerror() renvoie la taille du tampon requise pour contenir la chaîne.

ERREURS¶

Les erreurs suivantes peuvent être déclenchées par regcomp() :

REG_BADBR

Utilisation illégale de l'opérateur de référence inverse.

REG_BADPAT

Utilisation illégale d'un opérateur du type groupe ou liste.

REG_BADRPT

Utilisation illégale d'opérateurs de répétition, comme un caractère « * » en première place.

REG_EBRACE

Accolade manquante.

REG_EBRACK

Crochet manquant.

REG_ECOLLATE

Élément de collation invalide.

REG_ECTYPE

Nom de classe de caractères inconnu.

REG_EEND

Erreur non spécifique. Elle n'est pas définie par POSIX.

REG_EESCAPE

Barre oblique inverse de fin.

REG_EPAREN

Parenthèse manquante.

REG_ERANGE

Utilisation illégale de l'opérateur d'intervalle. Par exemple, la fin de l'intervalle est inférieure au début de l'intervalle.

REG_ESIZE

La compilation d'expressions rationnelles a besoin d'un tampon de taille supérieure à 64 Ko. Cela n'est pas défini par POSIX.

REG_ESPACE

Les routines regex ont épuisé la mémoire.

REG_ESUBREG

Référence inverse illégale vers une sous-expression.

ATTRIBUTS¶

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

STANDARDS¶

POSIX.1-2008.

HISTORIQUE¶

POSIX.1-2001.

Avant POSIX.1-2008, regoff_t était requis pour pouvoir stocker la plus grande valeur qui pouvait être contenue dans le type off_t ou dans le type ssize_ttype.

AVERTISSEMENTS¶

re_nsub n'est requis pour être initialisé si REG_NOSUB n'a pas été spécifié, mais toutes les implémentations connues l'initialisent de toutes façons.

À la fois regex_t et regmatch_t peuvent avoir (et ont) plus de membres dans n'importe quel ordre. Il faut toujours les référencer par leur nom.

EXEMPLES¶

#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <regex.h>
#define ARRAY_SIZE(arr) (sizeof((arr)) / sizeof((arr)[0]))
static const char *const str =


        "1) John Driverhacker;\n2) John Doe;\n3) John Foo;\n";
static const char *const re = "John.*o";
int main(void)
{


    static const char *s = str;


    regex_t     regex;


    regmatch_t  pmatch[1];


    regoff_t    off, len;


    if (regcomp(&regex, re, REG_NEWLINE))


        exit(EXIT_FAILURE);


    printf("String = \"%s\"\n", str);


    printf("Matches:\n");


    for (unsigned int i = 0; ; i++) {


        if (regexec(&regex, s, ARRAY_SIZE(pmatch), pmatch, 0))


            break;


        off = pmatch[0].rm_so + (s - str);


        len = pmatch[0].rm_eo - pmatch[0].rm_so;


        printf("#%zu:\n", i);


        printf("offset = %jd; length = %jd\n", (intmax_t) off,


                (intmax_t) len);


        printf("substring = \"%.*s\"\n", len, s + pmatch[0].rm_so);


        s += pmatch[0].rm_eo;


    }


    exit(EXIT_SUCCESS);
}

VOIR AUSSI¶

grep(1), regex(7)

La section Regular Expressions du manuel de la glibc

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org>, Frédéric Hantrais <fhantrais@gmail.com>, bubu <bubub@no-log.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.