CKTIS / C
getenv — funkcja środowiska C23
`getenv(name)` z `<stdlib.h>` przeszukuje listę środowiska hosta w poszukiwaniu wpisu pasującego do zakończonego nullem łańcucha `name`. Zwraca wskaźnik do łańcucha wartości, jeśli wpis istnieje, albo null, gdy nazwy nie znaleziono.
Wersja: C23
Składnia
char *getenv(const char *name);getenv(name) z <stdlib.h> przeszukuje listę środowiska hosta w poszukiwaniu wpisu pasującego do zakończonego nullem łańcucha name. Zwraca wskaźnik do łańcucha wartości, jeśli wpis istnieje, albo null, gdy nazwy nie znaleziono.
Przykład pobiera powszechną zmienną PATH i sprawdza, czy zwrócony wskaźnik jest nie-null oraz czy wartość nie jest pusta. W izolowanym środowisku wykonawczym wypisuje 1 1; kod nie zakłada konkretnej zawartości ani separatora ścieżek.
Nie modyfikuj wskazanego łańcucha: standard tego zabrania, a kolejne getenv może go nadpisać, więc trwałą wartość trzeba skopiować. Zbiór nazw i sposób zmiany środowiska zależą od implementacji. Funkcja nie musi unikać data race z wątkami modyfikującymi listę środowiska; synchronizuj takie operacje. Dane środowiska są wejściem zewnętrznym, więc waliduj je przed użyciem w ścieżkach, poleceniach lub konfiguracji bezpieczeństwa.
Przykłady
#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;}
Wynik
1 1
Przykład pobiera powszechną zmienną `PATH` i sprawdza, czy zwrócony wskaźnik jest nie-null oraz czy wartość nie jest pusta. W izolowanym środowisku wykonawczym wypisuje `1 1`; kod nie zakłada konkretnej zawartości ani separatora ścieżek.