NAME

getenv − Returns the value of an environment variable

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <stdlib.h>

char ∗getenv(
        const char ∗name);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

getenv():  XPG4, XPG4−UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

PARAMETERS

nameSpecifies the name of an environment variable. 

DESCRIPTION

The getenv() function searches the environment list for a string of the form name=value, and returns a pointer to a string containing the corresponding value for name. 

The returned string should not be modified by the application, but may be overwritten by a subsequent call to the getenv() or putenv() functions from the same thread. 

RETURN VALUES

The getenv() function returns a pointer to a string containing the value in the current environment if such a string is present.  If such a string is not present, a null pointer is returned. 

RELATED INFORMATION

Functions: putenv(3), clearenv(3)

Commands: sh(1)

Standards: standards(5)