Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

setenv - Umgebungsvariable ändern oder hinzufügen

&pagelevel(4)&pagelevel

Definition

#include <stdlib.h>

int setenv (const char *envname, const char *envval, int overwrite);

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.

Returnwert 

0

bei Erfolg.

 

-1

bei Fehler. errno wird gesetzt, um den Fehler anzuzeigen. Die Umgebung bleibt unverändert.

Siehe auch

environ, getenv, malloc, putenv, unsetenv, stdlib.h, Abschnitt "Umgebungsvariablen“