SETENV |
Fixe l'environnement |
GNU C |
stdlib.h |
Syntaxe
int setenv(const char *name, const char *value, int replace);
|
Paramètres
Nom |
Description |
name |
Ce paramètre permet d'indiquer le nom de la variable d'environnement. |
value |
Ce paramètre permet d'indiquer la valeur de la variable d'environnement. Un pointeur nul pour le paramètre value est considéré comme illégal. |
replace |
Ce paramètre permet d'indiquer s'il faut remplacé une entrée existante (1) ou ne rien changé lorsqu'il existe (0). |
Description
Cette fonction permet de fixer la valeur d'une variable d'environnement du système d'exploitation.
L'entrée portant le nom name est remplacée par la valeur 'nom = value'.
De plus, cette situation s'applique également si la valeur est la chaîne de caractères est vide.
Pour ce faire, une nouvelle chaîne de caractères est créée et le nom et la valeur des chaînes de caractères sont copiés.
Si la fonction réussit, elle renvoie 0. Sinon, l'environnement reste inchangé, la valeur de retour est -1 et errno contient le code d'erreur.
Remarques
- Vous ne pouvez pas supprimer complètement une entrée en utilisant cette fonction.
- Cette fonction faisait à l'origine partie de la bibliothèque BSD mais fait maintenant partie du standard Unix.
Dernière mise à jour : Lundi, le 29 avril 2019