7.20.4.5 The getenv function

Synopsis

1

#include <stdlib.h>
char *getenv(const char *name);

Description

2

The getenv function searches an environment list, provided by the host environment, for a string that matches the string pointed to by name. The set of environment names and the method for altering the environment list are implementation-defined.

3

The implementation shall behave as if no library function calls the getenv function.

Returns

4

The getenv function returns a pointer to a string associated with the matched list member. The string pointed to shall not be modified by the program, but may be overwritten by a subsequent call to the getenv function. If the specified name cannot be found, a null pointer is returned.