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

c
clearenv(3C) clearenv(3C)
NAME
clearenv - clear the process environment
SYNOPSIS
#include <stdlib.h>
int clearenv(void);
DESCRIPTION
clearenv() clears the process environment. No environment variables are defined immediately after a
call to clearenv().
clearenv() modifies the value of the pointer environ. This means that copies of that pointer are
invalid after a call to
clearenv().
RETURN VALUE
Upon successful completion,
clearenv() returns zero; otherwise, it returns −1 and sets
errno to
indicate the error.
ERRORS
clearenv() fails if the following condition is encountered:
[ENOMEM] Failed to free or reallocate memory for the process environment.
SEE ALSO
environ(5), getenv(3C), putenv(3C), thread_safety(5), <stdlib.h>.
STANDARDS CONFORMANCE
clearenv(): AES
Section 3−−106 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004