Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] regcomp, regexec, regerror, regfree - Fonctions regex POSIX. [size=18] [b]Résumé[/b] [/size] [b]#include <regex.h>[/b] .xx w'[b]int[/b] regcomp ('u [b][i]int regcomp (regex_t * preg , const char * regex , [/i][/b] [b][i]int cflags );[/i][/b] .xx w'[b]int[/b] regexec ('u [b][i]int regexec (const regex_t * preg , const char * string ,[/i][/b] [b][i]size_t nmatch , regmatch_t pmatch[] , [/i][/b] [b][i]int eflags );[/i][/b] .xx w'[b]size_t[/b] regerror ('u [b][i]size_t regerror (int errcode , [/i][/b] [b][i]const regex_t * preg , char * errbuf , [/i][/b] [b][i]size_t errbuf_size );[/i][/b] .xx w'[b]void[/b] regfree (' [b][i]void regfree (regex_t * preg );[/i][/b] [size=18] [b]Compilation regex posix[/b] [/size] [b]regcomp[/b] est utilisée pour compiler une expression régulière sous une forme utilisable par la suite pour des recherches avec [b]regexec .[/b] On fournit à [b]regcomp[/b] les arguments [b]preg ,[/b] un pointeur vers une zone de stockage du motif, [b]regex ,[/b] un pointeur vers une chaîne terminée par un caractère nul, et [b]cflags ,[/b] les attributs indiquant le type de compilation. Toutes les recherches d'expressions régulières sont effectuées à travers la zone de motif compilé, ainsi [b]regexec[/b] doit toujours recevoir l'adresse d'un motif initialisé par [b]regcomp .[/b] [i]cflags [/i] peut être un [b]OU binaire[/b] entre une ou plusieurs constantes symboliques suivantes : [b]REG_EXTENDED[/b] [table][row][col]    [/col][col]Utiliser la syntaxe d'Expression Régulière Étendue [b]POSIX[/b] pour interpréter [b]regex .[/b] Sinon, la syntaxe d'Expression Régulière de Base [b]POSIX[/b] est utilisée.[/col][/row][/table] [b]REG_ICASE[/b] [table][row][col]    [/col][col]Ne pas différencier les majuscules des minuscules. Les recherches [b]regexec[/b] suivantes utilisant le buffer de motif n'effectueront pas la différentiation.[/col][/row][/table] [b]REG_NOSUB[/b] [table][row][col]    [/col][col]Ne pas utiliser les correspondances de sous-chaînes. Les paramètres [i]nmatch[/i] et [i]pmatch[/i] de [b]regexec[/b] sont ignorés si le buffer de motif est compilé avec cet attribut.[/col][/row][/table] [b]REG_NEWLINE[/b] [table][row][col]    [/col][col]L'opérateur "n'importe-quel-caractère" ne s'identifie pas avec le saut de ligne. Une liste d'exceptions [b]( [^...] )[/b] s'identifie avec le saut de ligne, même si elle ne le contient pas explicitement. L'opérateur Début-de-ligne [b]( ^ )[/b] s'identifie avec une chaîne vide suivant immédiatement un saut de ligne, même si l'attribut [b]eflags ,[/b] de [b]regexec ,[/b] contient [b]REG_NOTBOL .[/b] L'opérateur Fin-de-ligne [b]( $ )[/b] s'identifie avec une chaîne vide précédant immédiatement un saut de ligne, même si l'attribut [b]eflags [/b] contient [b]REG_NOTEOL .[/b][/col][/row][/table] [size=18] [b]Correspondance regex posix[/b] [/size] [b]regexec[/b] est utilisée pour mettre en correspondance une chaîne terminée par un caractère nul, avec le buffer de motif précompilé [b]preg .[/b] [i]nmatch[/i] et [i]pmatch[/i] fournissent des informations concernant l'emplacement des correspondances. [i]eflags[/i] peut être un [b]OU binaire[/b] entre les constantes [b]REG_NOTBOL[/b] ou [b]REG_NOTEOL [/b] qui modifient le comportement de la mise en correspondance décrite ci-dessous. [b]REG_NOTBOL[/b] [table][row][col]    [/col][col]L'opérateur Début-de-ligne échoue toujours (mais voyez l'attribut de compilation [b]REG_NEWLINE [/b] ci-dessus) Cet attribut peut être utilisé quand différentes portions d'une chaîne sont transmises à [b]regexec[/b] et que le début de la chaine ne correspond pas à un début de ligne.[/col][/row][/table] [b]REG_NOTEOL[/b] [table][row][col]    [/col][col]L'opérateur Fin-de-ligne échoue toujours (mais voyez l'attribut de compilation [b]REG_NEWLINE[/b] ci-dessus)[/col][/row][/table] [b]Byte offsets[/b] A moins que l'attribut [b]REG_NOSUB[/b] n'ait été utilisé lors de la compilation du motif, il est possible d'obtenir des informations sur les correspondances de sous-chaînes. [i]pmatch[/i] doit être dimensionnée pour contenir au moins [i]nmatch[/i] éléments. Ils sont remplis par [b]regexec [/b] avec les adresses des sous-chaînes mises en correspondance. Tous les éléments inutilisés de structure, contiendront la valeur -1. La structure [b]regmatch_t [/b] du type [i]pmatch[/i] est définie dans [b]regex.h [/b] ainsi : .nf typedef struct { regoff_t rm_so; regoff_t rm_eo ; } regmatch_t; .fi Chaque élément [i]rm_so[/i] différent de -1 indique le point de départ de la sous-chaîne suivante la plus longue qui soit mise en correspondance. Cette valeur est un décalage (offset) dans la chaîne. L'élément [i]rm_eo [/i] indique le décalage de la fin de la sous-chaîne. [size=18] [b]Retour derreur posix[/b] [/size] [b]regerror[/b] est utilisé pour transformer les codes d'erreur renvoyés par [b]regcomp[/b] et par [b]regexec[/b] en libellés. [b]regerror[/b] reçoit le code [b]errcode ,[/b] le buffer de motif [b]preg ,[/b] un pointeur sur une chaîne de caractères [b]errbuf ,[/b] et la longueur maximale de cette chaîne [b]errbuf_size .[/b] Cette fonction renvoie la taille [i]errbuf[/i] nécessaire pour contenir le libellé d'erreur terminé par un caractère nul. Si [i]errbuf[/i] et [i]errbuf_size[/i] son non nuls, [i]errbuf[/i] est rempli avec les [i]errbuf_size - 1[/i] premiers caractères du libellé d'erreur, suivis d'un caractère nul. [size=18] [b]LibÉration du buffer de motif posix[/b] [/size] En fournissant à [b]regfree[/b] un buffer de motif précompilé [b]preg,[/b] il libérera la mémoire allouée au buffer durant la compilation avec [b]regcomp .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] [b]regcomp[/b] renvoie zéro si la compilation réussit, ou un code d'erreur en cas d'échec. [b]regexec[/b] renvoie zéro si la correspondance réussit, et [b]REG_NOMATCH[/b] si elle échoue. [size=18] [b]Erreurs[/b] [/size] Les erreurs suivantes peuvent être déclenchées par [b]regcomp :[/b] [b]REG_BADRPT[/b] [table][row][col]    [/col][col]Utilisation invalide d'opérateurs de répetition, comme un caractère [b]` * '[/b] en première place.[/col][/row][/table] [b]REG_BADBR[/b] [table][row][col]    [/col][col]Utilisation illégale de l'opérateur de référence inverse.[/col][/row][/table] [b]REG_EBRACE[/b] [table][row][col]    [/col][col]Crochet manquant.[/col][/row][/table] [b]REG_EBRACK[/b] [table][row][col]    [/col][col]Accolade manquante.[/col][/row][/table] [b]REG_ERANGE[/b] [table][row][col]    [/col][col]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.[/col][/row][/table] [b]REG_ECTYPE[/b] [table][row][col]    [/col][col]Nom de classe de caractère inconnu.[/col][/row][/table] [b]REG_EPAREN[/b] [table][row][col]    [/col][col]Parenthèse manquante.[/col][/row][/table] [b]REG_ESUBREG[/b] [table][row][col]    [/col][col]Référence inverse illégale vers une sous-expression.[/col][/row][/table] [b]REG_EEND[/b] [table][row][col]    [/col][col]Erreur non-spécifique.[/col][/row][/table] [b]REG_ESCAPE[/b] [table][row][col]    [/col][col]Séquence d'échappement invalide.[/col][/row][/table] [b]REG_BADPAT[/b] [table][row][col]    [/col][col]Utilisation illégale d'un opérateur du type groupe ou liste.[/col][/row][/table] [b]REG_ESIZE[/b] [table][row][col]    [/col][col]La compilation aurait besoin d'un buffer de taille supérieure à 64 Ko.[/col][/row][/table] [b]REG_ESPACE[/b] [table][row][col]    [/col][col]Pas assez de mémoire.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] POSIX [size=18] [b]Voir aussi[/b] [/size] [b]regex (7),[/b] [b]Manuel Regex GNU[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier