Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] argz_add, argz_add_sep, argz_append, argz_count, argz_create, argz_create_sep, argz_delete, argz_extract, argz_insert, argz_next, argz_replace, argz_stringify - functions to handle an argz list [size=18] [b]Résumé[/b] [/size] .nf [b]#include <argz.h>[/b] [b][i]error_t[/i][/b] [b][i]argz_add(char ** argz , size_t * argz_len , const char * str );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_add_sep(char ** argz , size_t * argz_len ,[/i][/b] .ti 20n [b][i]const char * str , int delim );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_append(char ** argz , size_t * argz_len ,[/i][/b] .ti 20n [b][i]const char * buf , size_t buf_len );[/i][/b] [b][i]size_t[/i][/b] [b][i]argz_count(const char * argz , size_t argz_len );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_create(char * const argv [], char ** argz ,[/i][/b] .ti 20n [b][i]size_t * argz_len );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_create_sep(const char * str , int sep , char ** argz ,[/i][/b] .ti 20n [b][i]size_t * argz_len );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_delete(char ** argz , size_t * argz_len , char * entry );[/i][/b] [b][i]void[/i][/b] [b][i]argz_extract(char * argz , size_t argz_len , char argv );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_insert (char argz , size_t * argz_len , char * before ,[/i][/b] .ti 20n [b][i]const char * entry );[/i][/b] [b][i]char [/i][/b] [b][i]argz_next(char argz , size_t argz_len , const char * entry );[/i][/b] [b][i]error_t[/i][/b] [b][i]argz_replace(char ** argz , size_t * argz_len , const char * str ,[/i][/b] .ti 20n [b][i]const char * with , unsigned int * replace_count );[/i][/b] [b][i]void[/i][/b] [b][i]argz_stringify(char * argz , size_t len , int sep );[/i][/b] [size=18] [b]Description[/b] [/size] Ces fonctions sont spécifiques à la GlibC.     Un vecteur argz est un pointeur sur un buffer de caractères associé à une longueur. L'inteprétation voulue pour le buffer de cartactères est un tableau de chaînes, ou les chaînes sont séparées par des octets nuls. Si la longueur est non nulle, le dernier octet du buffer doit être nul.     Ces fonctions servent à manipuler les vecteurs argz. La paire (NULL, 0) est un vecteur argz, et réciproquement les vecteurs argz de longueur zéro doivent avoir un pointeur NULL. L'allocation de vecteurs argz non nuls est faite avec [b]malloc (3),[/b] afin que [b]free (3)[/b] puisse être utilisé pour les libérer.     [b]argz_add()[/b] ajoute la chaîne [i]str[/i] à la fin de la table [i]* argz ,[/i] et met à jour [i]* argz[/i] et [i]* argz_len .[/i]     [b]argz_add_sep()[/b] est similaire, mais découpe la chaîne [i]str[/i] en sous-chaînes séparées par le délimiteur [b]delim .[/b] Par exemple, on peut l'utiliser sur la liste de recherche des chemins Unix avec le délimiteur ':'.     [b]argz_append()[/b] ajoute le vecteur argz [i]( buf , buf_len )[/i] à la fin de [i](* argz ,* argz_len )[/i] et met à jour [i]* argz[/i] et [i]* argz_len .[/i] (Donc, [i]* argz_len[/i] sera augmentée de [b]buf_len ).[/b]     [b]argz_count()[/b] compte le nombre de chaînes, c'est-à-dire de caractères nuls dans le vecteur [i]( argz , argz_len ).[/i]     [b]argz_create()[/b] convertit un vecteur de type argv Unix [b]argv ,[/b] terminé par (char ) 0, en un vecteur argz [i]( argz ,* argz_len ).[/i]     [b]argz_create_sep()[/b] convertit la chaîne terminée par un caractère nul [i]str[/i] en un vecteur argz [i](* argz ,* argz_len )[/i] en la découpant à chaque occurrence du séparateur [b]sep .[/b]     [b]argz_delete()[/b] retire la sous-chaîne pointée par [i]entry[/i] du vecteur argz [i](* argz ,* argz_len )[/i] et met à jour [i]* argz[/i] et [i]* argz_len .[/i]     [b]argz_extract()[/b] est l'inverse de [b]argz_create() .[/b] Elle prend le vecteur argz [i]( argz , argz_len )[/i] et remplit la table commençant à [i]argv[/i] avec des pointeurs sur les sous-chaines, et un NULL final en créant un vecteur de type argv Unix. La table [i]argv[/i] doit avoir assez de place pour [b]argz_count ( argz , argz_len ) + 1[/b] pointeurs.     [b]argz_insert()[/b] est l'opposée de [b]argz_delete() .[/b] Elle insère l'argument [i]entry[/i] à la position [i]before[/i] dans le vecteur argz [i](* argz ,* argz_len )[/i] et met à jour [i]* argz[/i] et [i]* argz_len .[/i] Si [i]before[/i] est NULL, alors [i]entry[/i] est insérée à la fin.     [b]argz_next()[/b] est une fonction pour se déplacer dans le vecteur argz. Si [i]entry[/i] est NULL, elle renvoie la première entrée. Sinon, l'entrée suivante est renvoyée. Elle renvoie NULL s'il n'y a pas d'entrée suivante.     [b]argz_replace()[/b] remplace chaque occurrence de [i]str[/i] avec [b]with ,[/b] en réallouant argz si nécessaire. Si [i]replace_count[/i] est non-NULL, [i]* replace_count[/i] sera incrémenté du nombre de remplacements.     [b]argz_stringify()[/b] est l'opposée de [b]argz_create_sep() .[/b] Elle transforme le vecteur argz en une chaîne normale en remplaçant tous les caractères nuls sauf le dernier par [b]sep .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] Tout les fonctions argz qui font de l'allocation mémoire ont un type de retour [i]error_t[/i], et renvoient [b]0[/b] si elles réussissent et [b]ENOMEM[/b] si l'allocation échoue. [size=18] [b]Bugs[/b] [/size] Les vecteurs argz sans caractère nul final conduisent une faute de segmentation. [size=18] [b]Notes[/b] [/size] Ces fonctions sont des extensions GNU, à utiliser avec précaution. [size=18] [b]Voir aussi[/b] [/size] [b]envz (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier