unsetenv - Umgebungsvariable entfernen

Definition	#include <stdlib.h> int unsetenv (const char *name);
Beschreibung	Die Funktion unsetenv() entfernt eine Variable aus der Umgebung des aufrufenden Prozesses. Das Argument name zeigt auf eine Zeichenkette, die den Namen der Variablen enthält, die entfernt werden soll. Diese Zeichenkette darf nicht das Zeichen '=' enthalten. Wenn die Variable in der aktuellen Umgebung nicht existiert, bleibt die Umgebung unverändert und die Funktion wird trotzdem erfolgreich beendet. Wenn die Anwendung environ, oder die Zeiger auf die environ zeigt, verändert, ist das Verhalten undefiniert. Die Funktion unsetenv() ändert die Liste der Zeiger auf die environ zeigt. unsetenv() ist nicht threadsicher.
Returnwert	0	bei Erolg.
	-1	bei Fehler. errno wird gesetzt, um den Fehler anzuzeigen. Die Umgebung bleibt unverändert.
Fehler	unsetenv() schlägt fehl, wenn gilt:
	EINVAL	Das Argument name ist der Nullzeiger, zeigt auf eine leere Zeichenkette, oder zeigt auf eine Zeichenkette, die das Zeichen '=' enthält.
Siehe auch	environ, exec, getenv(), malloc(), putenv(), setenv(), stdlib.h, Abschnitt "Umgebungsvariablen“.