NOM¶

envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip - Gestion des chaînes d'environnement

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <envz.h>

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 spécifiques à la glibc.

Un vecteur argz est un pointeur sur un tampon de caractère associé à une longueur, consultez argz_add(3). 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 correspondante est NULL (tandis qu'un « = » en dernière position indique une chaîne vide "").

Ces fonctions permettent la manipulation des vecteurs envz.

envz_add() ajoute la chaîne « name=value » (si value n'est pas NULL) ou « name » (si value est NULL) au vecteur envz (*envz, *envz_len) et met à jour *envz et *envz_len. Si une entrée avec le même name existe, elle est supprimée.

envz_entry() recherche name dans le vecteur envz (envz, envz_len) et renvoie son entrée si elle est trouvée, ou NULL sinon.

envz_get() recherche le name dans le vecteur envz (envz, envz_len) et renvoie sa valeur si elle est trouvée, et NULL sinon. (Notez que la valeur peut aussi être NULL, lorsqu'il y a une entrée pour name sans le signe « = »).

envz_merge() ajoute les entrées de envz2 dans *envz, comme avec envz_add(). Si override est vrai, alors les valeurs de envz2 écraseront celles avec le même nom dans *envz, sinon elles seront ignorées.

envz_remove() supprime l'entrée correspondant à name du vecteur (*envz, *envz_len) si elle s'y trouve.

envz_strip supprime toutes les entrées avec une valeur NULL.

VALEUR RENVOYÉE¶

Toutes les fonctions envz qui font une allocation mémoire ont un type de retour error_t (un type d'entier), et renvoient 0 en cas de succès et ENOMEM si une erreur d'allocation se produit.

ATTRIBUTS¶

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

STANDARDS¶

Ces fonctions sont une extension GNU.

EXEMPLES¶

#include <envz.h>
#include <stdio.h>
#include <stdlib.h>
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 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> et David Prévot <david@tilapin.org>

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.