HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

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.

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.