setenv   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (3)
Updated: 26 juillet 2007
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
setenv, unsetenv - Change ou ajoute une variable d'environnement  



SYNOPSIS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
#include <stdlib.h>

int setenv (const char *name, const char *value, int overwrite);

int unsetenv (const char *name);

Exigences de macros de test de fonctionalités pour la glibc (voir feature_test_macros(7)) :

setenv(), unsetenv() : _BSD_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600  




DESCRIPTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
La fonction setenv() ajoute la variable name dans l'environnement, en lui attribuant la valeur value, si name n'existe pas encore. Si name existe déjà dans l'environnement, alors sa valeur est modifiée en value si overwrite est non nul ; si overwrite vaut zéro, la valeur de name n'est pas modifiée. Cette fonction crée des copies des chaînes pointées par name et value (contrairement à putenv(3)).

La fonction unsetenv() efface la variable name de l'environnement. Si name n'existe pas dans l'environnement, la fonction réussit et l'environnement n'est pas modifié.  




VALEUR RENVOYÉE   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
La fonction setenv() renvoie zéro si elle reussit, ou -1 si il n'y a pas assez de place dans l'environnement.

La fonction unsetenv() renvoie zéro si elle réussit, et -1 si elle échoue, auquel cas errno contient le code de l'erreur.  




ERREURS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
EINVAL
name contient un caractère « = ».
 



CONFORMITÉ   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
BSD 4.3, POSIX.1-2001.  



NOTES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
POSIX.1-2001 ne demande pas que setenv() ou unsetenv() soit réentrante.

Avant la glibc 2.2.2, unsetenv() était prototypée pour retourner void ; les versions de la glibc plus récentes suivent le prototype conforme à POSIX.1-2001 comme montré dans le SYNOPSIS.  




BOGUES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
POSIX.1-2001 indique que si name contient un caractère « = », alors setenv() devrait échouer avec l'erreur EINVAL ; toutefois, les versions de la glibc antérieures à 2.3.4 autorisaient l'utilisation du caractère « = » dans name.  



VOIR AUSSI   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
clearenv(3), getenv(3), putenv(3), environ(7)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 7 novembre 1996 et révisée le 6 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 setenv ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
BOGUES
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
EINVALERREURS



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:49:40, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional