Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes