GETENV(3)

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.