Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip - Support des chaînes d'environnement. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <envz.h>[/b] [b][i]error_t[/i][/b] [b][i]envz_add(char ** envz , size_t * envz_len ,[/i][/b] .ti 16n [b][i]const char * nom , const char * valeur );[/i][/b] [b][i]char [/i][/b] [b][i]envz_entry(const char envz , size_t * envz_len , const char * nom );[/i][/b] [b][i]char [/i][/b] [b][i]envz_get(const char envz , size_t * envz_len , const char * nom );[/i][/b] [b][i]error_t[/i][/b] [b][i]envz_merge(char ** envz , size_t * envz_len ,[/i][/b] .ti 16n [b][i]const char * envz2 , size_t envz2_len , int override );[/i][/b] [b][i]void[/i][/b] [b][i]envz_remove(char ** envz , size_t * envz_len , const char * nom );[/i][/b] [b][i]void[/i][/b] [b][i]envz_strip(char ** envz , size_t * envz_len );[/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ère associé à une longueur, voyez [b]argz_add (3).[/b] Un vecteur envz est un vecteur argz spécial, plus précisément un dont les chaînes ont la forme "nom=valeur". Tout ce qui suit le '=' est considéré comme la valeur. S'il n'y a pas de '=', la valeur correspondant est NULL (tandis qu'un '=' en dernière position indique une chaîne valeur vide "").     Ces fonctions permettent la manipulation des vecteurs envz.     [b]envz_add()[/b] ajoute la chaîne [i]& nom = valeur &[/i] (si [i]valeur[/i] n'est pas NULL) ou [i]& nom &[/i] (si la [i]valeur[/i] est NULL) au vecteur envz [i](* envz ,* envz_len )[/i] et met à jour [i]* envz[/i] et [i]* envz_len .[/i] Si une entrée avec le même [i]nom[/i] existe, elle est supprimée.     [b]envz_entry()[/b] recherche le [i]nom[/i] dans le vecteur envz [i]( envz , envz_len )[/i] et renvoie son entrée si elle est trouvée, ou NULL sinon.     [b]envz_get()[/b] recherche le [i]name[/i] dans le vecteur envz [i]( envz , envz_len )[/i] et renvoie sa valeur si elle est trouvée, et NULL sinon. (Notez que la valeur peut aussi être NULL, lorsqu'il y a un entrée pour [i]nom[/i] sans le signe '=')     [b]envz_merge()[/b] ajoute les entrées de [i]envz2[/i] dans [i]* envz ,[/i] comme avec [b]envz_add() .[/b] Si [i]override[/i] est vrai, alors les valeurs de [i]envz2[/i] écraseront celles avec le même nom dans [i]* envz ,[/i] sinon elles seront ignorées.     [b]envz_remove()[/b] supprime l'entrée correspondant au [i]nom[/i] du vecteur [i](* envz ,* envz_len )[/i] si elle s'y trouve.     [b]envz_strip[/b] supprime toutes les entrées avec une valeur NULL. [size=18] [b]Valeur renvoyée[/b] [/size] Toutes les fonctions envz qui font une 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 une erreur d'allocation se produit. [size=18] [b]Exemple[/b] [/size] .nf #include <stdio.h> #include <envz.h> int main(int argc, char argv[], char envp[]) { int i, e_len = 0; char str; for (i=0; envp[i] != NULL; i++) e_len += strlen(envp[i]) + 1; str = envz_entry(envp, e_len, "HOME"); printf("%sen", str); str = envz_get(*envp, e_len, "HOME"); printf("%sen", str); return 0; } .fi [size=18] [b]Notes[/b] [/size] Ces fonctions sont des extensions GNU à traiter avec précaution. [size=18] [b]Voir aussi[/b] [/size] [b]argz (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2003.
Fichier