Index Index for
Section 3
Index Alphabetical
listing for G
Bottom of page Bottom of
page

getenv(3)

NAME

getenv - Return the value of an environment variable

SYNOPSIS

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

LIBRARY

Standard C Library (libc)

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

name Specifies 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.

SEE ALSO

Functions: putenv(3), clearenv(3) Commands: sh(1) Standards: standards(5)

Index Index for
Section 3
Index Alphabetical
listing for G
Top of page Top of
page