Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła