CKTIS / C
getenv — funkce prostředí C23
`getenv(name)` z `<stdlib.h>` hledá v seznamu prostředí hostitele položku odpovídající řetězci `name` ukončenému nulou. Pokud položka existuje, vrátí ukazatel na řetězec hodnoty, jinak null ukazatel.
Verze: C23
Syntaxe
char *getenv(const char *name);getenv(name) z <stdlib.h> hledá v seznamu prostředí hostitele položku odpovídající řetězci name ukončenému nulou. Pokud položka existuje, vrátí ukazatel na řetězec hodnoty, jinak null ukazatel.
Příklad se dotáže na běžnou proměnnou PATH a ověří, že ukazatel není null a hodnota není prázdná. V izolovaném prostředí vytiskne 1 1, aniž předpokládá konkrétní obsah či oddělovač cest.
Na označený řetězec nezapisujte: norma to zakazuje a další getenv jej smí přepsat; trvalou hodnotu zkopírujte. Množina názvů a způsob změny prostředí závisejí na implementaci. Funkce nemusí zabránit data race s vlákny, která seznam mění; takové operace synchronizujte. Prostředí je externí vstup, proto je validujte před použitím v cestách, příkazech či bezpečnostní konfiguraci.
Příklady
#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;}
Výsledek
1 1
Příklad se dotáže na běžnou proměnnou `PATH` a ověří, že ukazatel není null a hodnota není prázdná. V izolovaném prostředí vytiskne `1 1`, aniž předpokládá konkrétní obsah či oddělovač cest.