Synopsis

PDX_MSGT ugn_GetEnv(long option, const char *name, char **value)

Purpose

Obtain environment variable value.

Description

The value for the environment variable name will be returned as a string pointer in value. This string should not be modified by the caller. If an alias has been defined for name, the alias will be searched for in the environment. If no alias was defined, the variable name will be searched for. If an alias was defined for name and such an environement variable does not exist, a search will be made for an environment variable of @a name. In either case, if ugn_SetEnv was used to set the value of an environment variable, that value will be returned otherwise the value from the real environment will be returned. If the variable can not be located in the environment, a NULL pointer will be returned in value.

Input

option

Options (not used)

name

Environment variable to return value of

value

Address to store the pointer to the value at

Output

value

The value of the specified environment variable or NULL

Return

UGN error code