envz_add(3) Library Functions Manual envz_add(3) NOM envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip - Gestion des chaines d'environnement BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include error_t envz_add(char **restrict envz, size_t *restrict envz_len, const char *restrict name, const char *restrict value); char *envz_entry(const char *restrict envz, size_t envz_len, const char *restrict name); char *envz_get(const char *restrict envz, size_t envz_len, const char *restrict name); error_t envz_merge(char **restrict envz, size_t *restrict envz_len, const char *restrict envz2, size_t envz2_len, int override); void envz_remove(char **restrict envz, size_t *restrict envz_len, const char *restrict name); void envz_strip(char **restrict envz, size_t *restrict envz_len); DESCRIPTION Ces fonctions sont specifiques a la glibc. Un vecteur argz est un pointeur sur un tampon de caractere associe a une longueur, consultez argz_add(3). Un vecteur envz est un vecteur argz special, plus precisement un dont les chaines ont la forme << nom=valeur >>. Tout ce qui suit le << = >> est considere comme la valeur. S'il n'y a pas de << = >>, la valeur correspondante est NULL (tandis qu'un << = >> en derniere position indique une chaine vide ""). Ces fonctions permettent la manipulation des vecteurs envz. envz_add() ajoute la chaine << name=value >> (si value n'est pas NULL) ou << name >> (si value est NULL) au vecteur envz (*envz, *envz_len) et met a jour *envz et *envz_len. Si une entree avec le meme name existe, elle est supprimee. envz_entry() recherche name dans le vecteur envz (envz, envz_len) et renvoie son entree si elle est trouvee, ou NULL sinon. envz_get() recherche le name dans le vecteur envz (envz, envz_len) et renvoie sa valeur si elle est trouvee, et NULL sinon. (Notez que la valeur peut aussi etre NULL, lorsqu'il y a une entree pour name sans le signe << = >>). envz_merge() ajoute les entrees de envz2 dans *envz, comme avec envz_add(). Si override est vrai, alors les valeurs de envz2 ecraseront celles avec le meme nom dans *envz, sinon elles seront ignorees. envz_remove() supprime l'entree correspondant a name du vecteur (*envz, *envz_len) si elle s'y trouve. envz_strip supprime toutes les entrees avec une valeur NULL. VALEUR RENVOYEE Toutes les fonctions envz qui font une allocation memoire ont un type de retour error_t (un type d'entier), et renvoient 0 en cas de succes et ENOMEM si une erreur d'allocation se produit. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +---------------------------------+--------------------------+---------+ |Interface | Attribut | Valeur | +---------------------------------+--------------------------+---------+ |envz_add(), envz_entry(), | Securite des threads | MT-Safe | |envz_get(), envz_merge(), | | | |envz_remove(), envz_strip() | | | +---------------------------------+--------------------------+---------+ STANDARDS GNU. EXEMPLES #include #include #include int main(int argc, char *argv[], char *envp[]) { char *str; size_t e_len = 0; for (size_t i = 0; envp[i] != NULL; i++) e_len += strlen(envp[i]) + 1; str = envz_entry(*envp, e_len, "HOME"); printf("%s\n", str); str = envz_get(*envp, e_len, "HOME"); printf("%s\n", str); exit(EXIT_SUCCESS); } VOIR AUSSI argz_add(3) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier et David Prevot Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 envz_add(3)