GETENV

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 17 mars 2008
Index Menu principal  

NOM

getenv - Lire une variable d'environnement  

SYNOPSIS

#include <stdlib.h>

char *getenv(const char *name);
 

DESCRIPTION

La fonction getenv() recherche dans la liste des variables d'environnement un variable nommée name, et renvoie un pointeur sur la chaîne value correspondante.  

VALEUR RENVOYÉE

La fonction getenv() renvoie un pointeur sur la valeur correspondante, dans l'environnement du processus, ou NULL s'il n'y a pas de correspondance.  

CONFORMITÉ

SVr4, POSIX.1-2001, BSD 4.3, C89, C99.  

NOTES

Les chaînes dans la liste des variables d'environnement sont de la forme nom=valeur.

Telle qu'elle est généralement implémentée, getenv() renvoie un pointeur vers une chaîne de la liste d'environnement. L'appelant doit faire attention de ne pas modifier cette chaîne car cela modifierait l'environnement du processus.

L'implémentation de getenv() ne nécessite pas qu'elle soit réentrante. La chaîne pointée par la valeur de retour de getenv() peut être allouée statiquement et peut être modifiée par un appel ultérieur à getenv(), putenv(3), setenv(3) ou unsetenv(3).  

VOIR AUSSI

clearenv(3), putenv(3), setenv(3), unsetenv(3), environ(7)  

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 26 octobre 1996 et révisée le 17 juillet 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 getenv ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
CONFORMITÉ
NOTES
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 17 juillet 2008