sourCEntral - mobile manpages

pdf

envz_add

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 (envzenvz_len) et renvoie son entrée si elle est trouvée, ou NULL sinon.

envz_get() recherche le name dans le vecteur envz (envzenvz_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).

img

STANDARDS

Ces fonctions sont une extension de 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 DOT rafin AT laposte DOT net>, Thierry Vignaud <tvignaud AT mandriva DOT com>, François Micaux, Alain Portal <aportal AT univ-montp2 DOT fr>, Jean-Philippe Guérard <fevrier AT tigreraye DOT org>, Jean-Luc Coulon (f5ibh) <jean-luc DOT coulon AT wanadoo DOT fr>, Julien Cristau <jcristau AT debian DOT org>, Thomas Huriaux <thomas DOT huriaux AT gmail DOT com>, Nicolas François <nicolas DOT francois AT centraliens DOT net>, Florentin Duneau <fduneau AT gmail DOT com>, Simon Paillard <simon DOT paillard AT resel DOT enst-bretagne DOT fr>, Denis Barbier <barbier AT debian DOT org> et David Prévot <david AT tilapin DOT 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.

pdf