setenv - Umgebungsvariable ändern oder hinzufügen

Definition	#include <stdlib.h> int setenv (const char *envname, const char *envval, int overwrite);
Beschreibung	Die Funktion setenv() ändert eine Variable der Umgebung des aufrufenden Prozesses oder fügt eine neue hinzu. Das Argument envname zeigt auf eine Zeichenkette, die den Namen einer Umgebungsvariable enthält, die geändert oder hinzugefügt werden soll. Wenn die Umgebungsvariable bereits existiert, sind zwei Fälle zu unterscheiden: Falls der Wert von overwrite verschieden von Null ist, wird die Umgebung geändert, falls der Wert Null ist, bleibt die Umgebung unverändert. In beiden Fällen wird die Funktion erfolgreich beendet. Wenn die Anwendung environ, oder die Zeiger auf die environ zeigt, verändert, ist das Verhalten undefiniert. Die Funktion setenv() ändert die Liste der Zeiger auf die environ zeigt. Die Zeichenketten auf die envname und envval zeigen, werden durch die Funktion kopiert. setenv() ist nicht threadsicher.
Returnwert	0	bei Erfolg.
	-1	bei Fehler. errno wird gesetzt, um den Fehler anzuzeigen. Die Umgebung bleibt unverändert.
Fehler	setenv() schlägt fehl, wenn gilt:
	EINVAL	Das Argument envname ist der Nullzeiger, zeigt auf eine leere Zeichenkette, oder zeigt auf eine Zeichenkette, die das Zeichen '=' enthält.
	ENOMEM	Der Speicher reicht nicht aus um die Variable oder ihren Wert der Umgebung hinzuzufügen.
Siehe auch	environ, exec, getenv(), malloc(), putenv(), unsetenv(), stdlib.h, Abschnitt "Umgebungsvariablen“.