HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
g
getenv(3C) getenv(3C)
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.
APPLICATION USAGE
getenv() is thread-safe. It is not async-cancel-safe.
WARNINGS
getenv() returns a pointer to static data which can be overwritten by subsequent calls.
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.
SEE ALSO
exec(2), putenv(3C), environ(5).
STANDARDS CONFORMANCE
getenv(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, POSIX.2, ANSI C
Section 3−−296 − 1 − HP-UX Release 11i: December 2000
___
___