PURPOSE

tuxgetenv - return value for environment name

SYNOPSIS


#include <atmi.h>
char *tuxgetenv(char *name)

DESCRIPTION

tuxgetenv() searches the environment list for a string of the form name=value and, if the string is present, returns a pointer to the value in the current environment. Otherwise, it returns a null pointer.

This function provides a portable interface to environment variables across the different platforms on which TUXEDO is supported, including those platforms that don't normally have environment variables.

Note that tuxgetenv is case-sensitive.

RETURN VALUES

tuxgetenv() returns a pointer to the string if present and a null pointer otherwise.

PORTABILITY

On MS Windows, this function overcomes the inability to share environment variables between an application and a Dynamic Link Library. The TUXEDO /WS DLL maintains an environment copy for each application that is attached to it. This associated environment and context information is destroyed when tpterm(3c) is called from a Windows application. The value of an environment variable could be changed after the application program calls tpterm(3c).

It is recommended that upper case variable names be used for the DOS, Windows, OS/2, and NetWare environments ( tuxreadenv(3c) converts all environment variable names to upper case).

SEE ALSO

tuxputenv(3c),
tuxreadenv(3c)