Fonction getenv

Entête à inclure

#include <stdlib.h>  // <cstdlib> en C++

Fonction getenv

char * getenv( const char * varName );

Cette fonction est utilisée pour récupérer le contenu d'une variable d'environnement. Les variables d'environnement sont définies par le système d'exploitation utilisé et permmettent d'obtenir des informations sur l'environnement dans lequel s'exécute le processus (le programme) en cours.

Paramètres

  • varName : définie le nom de la variable d'environnement souhaitée. Notez que, conventionnellement, les variables d'environnement sont souvent nommées en majuscules (bien que cela ne soit pas une obligation absolue). Par exemple : PATH, LD_LIBRARY_PATH, ...

Valeur de retour

Si la variable d'environnement demandée n'existe pas, un pointeur nul (NULL) vous sera retourné. Dans le cas ou la variable existe bel et bien, sa valeur (une chaine de caractères) vous sera retourné. Il ne faut surtout pas chercher à libérer la mémoire de la variable d'environnement après son utilisation : en fait, elle est stockée dans une zone de mémoire gérée par le processus et vous ne devez en aucun cas chercher à modifier cette valeur.

Exemple de code

#include <stdio.h>
#include <stdlib.h>

int main() {

    const char * path = getenv( "PATH" );
    printf( "PATH environment variable == %s\n", path );

    return 0;
}

Fonctions connexes