CKTIS / C
getenv — C23-Umgebungsfunktion
`getenv(name)` aus `<stdlib.h>` durchsucht die Umgebungslist des Hosts nach einem Eintrag, der zur nullterminierten Zeichenkette `name` passt. Es liefert einen Zeiger auf die Wertzeichenkette oder einen Nullzeiger, wenn der Name fehlt.
Version: C23
Syntax
char *getenv(const char *name);getenv(name) aus <stdlib.h> durchsucht die Umgebungslist des Hosts nach einem Eintrag, der zur nullterminierten Zeichenkette name passt. Es liefert einen Zeiger auf die Wertzeichenkette oder einen Nullzeiger, wenn der Name fehlt.
Das Beispiel fragt die verbreitete Variable PATH ab und prüft, ob der Zeiger nicht null und der Wert nicht leer ist. In der isolierten Ausführungsumgebung druckt es 1 1; weder Inhalt noch Pfadtrenner werden vorausgesetzt.
Die bezeichnete Zeichenkette nicht ändern: der Standard verbietet es und ein späteres getenv darf sie überschreiben; dauerhafte Werte kopieren. Namensmenge und Änderungsmethode sind implementationsabhängig. Die Funktion muss Data Races mit Threads, die die Umgebungsliste ändern, nicht vermeiden; solche Zugriffe synchronisieren. Umgebungsdaten sind externe Eingabe und vor Nutzung in Pfaden, Befehlen oder Sicherheitskonfiguration zu validieren.
Beispiele
#include <stdio.h>
#include <stdlib.h>
int main(void){const char *value=getenv("PATH");printf("%d %d\n",value!=NULL,value!=NULL&&value[0]!='\0');return 0;}
Ergebnis
1 1
Das Beispiel fragt die verbreitete Variable `PATH` ab und prüft, ob der Zeiger nicht null und der Wert nicht leer ist. In der isolierten Ausführungsumgebung druckt es `1 1`; weder Inhalt noch Pfadtrenner werden vorausgesetzt.