Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

unsetenv()

Remove an environment variable

Synopsis:

#include <stdlib.h>

void unsetenv( const char* name );

Arguments:

name
The name of the environment variable that you want to delete.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The unsetenv() function removes the environment variable named name from the process's environment.

Classification:

POSIX 1003.1

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Caveats:

The unsetenv() function manipulates the environment pointed to by the global environ variable.

See also:

clearenv(), getenv(), putenv(), setenv()