Langage de programmation - C++ - Référence de procédures et de fonctions

GETENV	Demande à l'environnement
Langage C++	cstdlib (stdlib.h)

Syntaxe

int getenv(const char *vnom)

Paramètres

Nom	Description
vnom	Ce paramètre permet d'indiquer le nom de la variable d'environnement :
	Variable	Description	Portabilité
	"ALLUSERSPROFILE"	Cette variable permet d'indiquer le répertoire où est situé le profile utilisateur pour tous les utilisateurs	Windows NT
	"APPDATA"	Cette variable permet d'indiquer le répertoire où sont situés les données d'application de l'utilisateur courant	Windows NT
	"BLASTER"	Cette variable permet d'indiquer les paramètres de la carte de son de type «SoundBlaster»	Application
	"CFGFILE"	Cette variable permet d'indiquer l'emplacement du fichier de configuration du système d'exploitation.	FreeDOS
	"CLASSPATH"	Cette variable permet d'indiquer le répertoire de recherche pour le Java.	Application Java
	"CommonProgramFiles"	Cette variable permet d'indiquer le répertoire où sont situés les fichiers communs d'application	Windows NT
	"COMPUTERNAME"	Cette variable permet d'indiquer le nom de l'ordinateur	Windows NT
	"COMSPEC"	Cette variable permet d'indiquer le nom de l'interpréteur de commande	DOS, OS/2, Windows
	"CONFIG"	Cette variable permet d'indiquer le nom de la configuration lors du démarrage du système d'exploitation.	FreeDOS, MS-DOS
	"DESKTOP_SESSION"	Cette variable permet d'indiquer le nom de l'environnement graphique : gnome,...	Linux
	"DIRCMD"	Cette variable permet d'indiquer les paramètres par défaut de la commande «DIR» de l'interpréteur de commande	DOS, OS/2, Windows
	"DOSDIR"	Cette variable permet d'indiquer le répertoire du système d'exploitation DOS.	FreeDOS
	"HELPPATH"	Cette variable permet d'indiquer le répertoire d'aide du système d'exploitation.	FreeDOS
	"HOME"	Cette variable permet d'indiquer le dossier où se situe les informations de compte de l'utilisateur courant.	Linux
	"HOMEDRIVE"	Cette variable permet d'indiquer l'unité de disque de l'utilisateur courant	Windows NT
	"HOMEPATH"	Cette variable permet d'indiquer le répertoire de l'utilisateur courant	Windows NT
	"LANG"	Cette variable permet d'indiquer les MID de langue courante du système d'exploitation (FR=Français, EN=anglais,...)	FreeDOS, Linux
	"LOGONSERVER"	Cette variable permet d'indiquer le chemin réseau pour se connecter au serveur	Windows NT
	"MALTE"	Cette variable permet d'indiquer le répertoire racine de le progiciel MonsterBook	Application
	"NLSPATH"	Cette variable permet d'indiquer le répertoire de configuration international du système d'exploitation.	FreeDOS
	"NUMBER_OF_PROCESSORS"	Cette variable permet d'indiquer le nombre de microprocesseur détecté sur la machine	Windows NT
	"OS"	Cette variable permet d'indiquer le nom du système d'exploitation	Windows NT
	"PATH"	Cette variable permet d'indiquer le répertoire de recherche pour les applications du système d'exploitation	DOS, OS/2, Windows, Linux
	"PATHEXT"	Cette variable permet d'indiquer les extensions exécutable sur le système d'exploitation. Ils sont séparés par des points-virgule (;).	Windows NT
	"PROCESSOR_ARCHITECTURE"	Cette variable permet d'indiquer le type de microprocesseur fonctionnant sur la machine.	Windows NT
	"PROCESSOR_IDENTIFIER"	Cette variable permet d'indiquer l'identificateur de microprocesseur fonctionnant sur la machine.	Windows NT
	"PROCESSOR_LEVEL"	Cette variable permet d'indiquer le niveau de génération du microprocesseur fonctionnant sur la machine.	Windows NT
	"PROCESSOR_REVISION"	Cette variable permet d'indiquer le numéro de révision du microprocesseur fonctionnant sur la machine.	Windows NT
	"ProgramFiles"	Cette variable permet d'indiquer le répertoire où sont situé les applications installé avec ce système d'exploitation	Windows NT
	"PROMPT"	Cette variable permet d'indiquer l'aspect d'affichage du prompt de l'interpréteur de commande	DOS, OS/2, Windows
	"QTJAVA"	Cette variable permet d'indiquer le répertoire de recherche pour le QuickTime avec Java.	Application Java
	"SESSIONNAME"	Cette variable permet d'indiquer le nom de session en cours.	Windows NT
	"SHELL"	Cette variable permet d'indiquer le nom de l'interpréteur de commande courant.	Linux
	"SystemDrive"	Cette variable permet d'indiquer l'unité de disque du système d'exploitation.	Windows NT
	"SystemRoot"	Cette variable permet d'indiquer le répertoire racine du système d'exploitation.	Windows NT
	"TEMP"	Cette variable permet d'indiquer le répertoire pour les données temporaire d'application	DOS, OS/2, Windows
	"TMP"	Cette variable permet d'indiquer le répertoire pour les données temporaire d'application	DOS, OS/2, Windows
	"USER"	Cette variable permet d'indiquer l'identificateur de l'utilisateur courant.	Linux
	"USERDOMAIN"	Cette variable permet d'indiquer le nom de domaine de l'utilisateur courant.	Windows NT
	"USERNAME"	Cette variable permet d'indiquer le nom de l'utilisateur courant.	Windows NT, Linux
	"USERPROFILE"	Cette variable permet d'indiquer le chemin où est situé le profile de l'utilisateur courant.	Windows NT
	"WATTCP.CFG"	Cette variable permet d'indiquer le répertoire d'emplacement du fichier de configuration du Watcom C++	Application
	"WINDIR"	Cette variable permet d'indiquer le répertoire racine de Windows	OS/2, Windows
	...	...	...

Description

Cette fonction effectue la lecture d'une variable d'environnement système.

Remarques

La fonction getenv() renvoie un pointeur sur les informations de variables d'environnements du système d'exploitation associées à la chaîne de caractères pointée par nom dans la table d'informations des variables d'environnements définies par la mise en oeuvre du compilateur. La chaîne de caractères retournée ne doit jamais être modifiée par le programme.
Les variables d'environnement d'un programme peut inclure des éléments tels que les noms de chemin et les périphériques en ligne. La nature exacte de ces données est définie par la mise en oeuvre du compilateur. Vous devrez vous référer à la documentation de la marque de votre compilateur pour plus de détails.
Si un appel est fait à la fonction getenv() avec un paramètre ne correspondant à aucune des données des variables d'environnement, un pointeur null est retourné.

Exemple

Voici un exemple montrant une utilisation à la suite d'un test :

Essayer maintenant !



				
#include <iostream>

#include <cstdlib>

 
int main()


{

    std::cout << "PATH = " << getenv("PATH") << std::endl;


    return 0;

}

on pourrait obtenir résultat semblable à celui-ci sous Windows Vista :

PATH = .;C:\Program Files (x86)\CodeBlocks\MinGW\bin;C:\Program Files\Common Files\Microsoft Shared\Windows Live;C:\Program Files (x86)\Common Files\Microsoft Shared\Windows Live;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\hp\bin\Python;c:\Program Files (x86)\Microsoft SQL Server\90\Tools\binn\;C:\Program Files (x86)\QuickTime\QTSystem\;C:\Program Files (x86)\Windows Live\Shared;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Sun\SDK\bin

ou on pourrait obtenir résultat semblable à celui-ci sous Linux Ubuntu :

PATH = /usr/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/sbin:/bin:/usr/games

Voir également

Langage de programmation - C - Référence de procédures et fonctions - getenv

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 732.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 127.

Dernière mise à jour : Lundi, le 3 août 2015

Section courante

A propos

Section administrative du site

GETENV