char * getenv ( const char * name );

<cstdlib>

Get environment string

Retrieves a C string containing the value of the environment variable whose name is specified as argument. If the requested variable is not part of the environment list, the function returns a NULL pointer.

The string pointed by the pointer returned by this function shall not be modified by the program.

The same memory location may be used in subsequent calls to getenv, overwriting the previous content.

Parameters

name

C string containing the name of the requested variable.

Return Value

Portability

Example

/* getenv example: getting path */
#include <stdio.h>
#include <stdlib.h>

int main ()
{
  char * pPath;
  pPath = getenv ("PATH");
  if (pPath!=NULL)
    printf ("The current path is: %s",pPath);
  return 0;
}

See also