NAME

getenv() − return value for environment name

SYNOPSIS

#include <stdlib.h>

char *getenv(const char *name);

DESCRIPTION

getenv() searches the environment list (see environ(5)) for a string of the form name=value, and returns a pointer to the value in the current environment if such a string is present, otherwise a NULL pointer.  name can be either the desired name, null-terminated, or of the form name=value, in which case getenv() uses the portion to the left of the = as the search key. 

WARNINGS

getenv() returns a pointer to static data which can be overwritten by subsequent calls. 

SEE ALSO

exec(2), putenv(3C), environ(5). 

EXTERNAL INFLUENCES

Locale

The LC_CTYPE category determines the interpretation of characters in name as single- and/or multi-byte characters. 

International Code Set Support

Single- and multi-byte character code sets are supported. 

STANDARDS CONFORMANCE

getenv(): AES, SVID2, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992