CKTIS / C
getenv — função de ambiente C23
`getenv(name)` de `<stdlib.h>` procura na lista do ambiente anfitrião uma entrada correspondente à string terminada em null `name`. Devolve ponteiro para a string do valor se existir ou ponteiro null quando o nome não é encontrado.
Versão: C23
Sintaxe
char *getenv(const char *name);getenv(name) de <stdlib.h> procura na lista do ambiente anfitrião uma entrada correspondente à string terminada em null name. Devolve ponteiro para a string do valor se existir ou ponteiro null quando o nome não é encontrado.
O exemplo consulta a variável comum PATH e testa se o ponteiro não é null e o valor não está vazio. No ambiente de execução isolado imprime 1 1, sem presumir conteúdo ou separador de caminhos específico.
Não modifiques a string apontada: a norma proíbe-o e uma chamada posterior a getenv pode sobrescrevê-la; copia um valor que tenha de persistir. O conjunto de nomes e a forma de mudar o ambiente dependem da implementação. A função não tem de evitar uma data race com threads que alterem a lista; sincroniza essas operações. O ambiente é entrada externa, portanto valida-o antes de o usar em caminhos, comandos ou configuração de segurança.
Exemplos
#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;}
Resultado
1 1
O exemplo consulta a variável comum `PATH` e testa se o ponteiro não é null e o valor não está vazio. No ambiente de execução isolado imprime `1 1`, sem presumir conteúdo ou separador de caminhos específico.