clearenv − löscht die Liste der Umgebungsvariablen.
#include <stdlib.h>
int clearenv(void);
Die Funktion clearenv() löscht alle Name-Werte-Paare aus der Liste der Umgebungsvariablen.
Wurde die Funktion clearenv() erfolgreich ausgeführt, gibt sie null zurück. Ein von null verschiedener Rückgabewert zeigt einen Fehler an.
Nicht vorhanden in libc4, libc5. In glibc seit Version 2.0.
Verschiedenen Unix-Varianten (DGUX, HPUX, QNX, ...). POSIX.9 (Schnittstellen zu FORTRAN77). POSIX.1-1996 hat clearenv() und putenv() zunächst nicht akzeptiert, sich jedoch umentschieden und geplant, die Funktionen in einer späteren Ausgabe des Standards aufzunehmen. (s. B.4.6.1). SUSv3 enthält jedoch nur putenv() und hat clearenv() zurückgewiesen.
Wird in Programmen verwendet, die Wert auf Sicherheit legen. Falls die Funktion selbst nicht verfügbar ist, erfüllt die Zuweisung
environ = NULL; |
möglicherweise denselben Zweck.