getenv 子例程

用途

返回环境变量的值。

标准 C 库 (libc.a)

语法

#include <stdlib.h>
char *getenv ( Name)
const char *Name;

描述

getenv 子例程在环境列表中搜索格式为 Name=Value的字符串。 环境变量有时称为 shell 变量,因为它们经常使用 shell 命令进行设置。

参数

描述
名称 指定环境变量的名称。 如果当前环境中不存在正确格式的字符串,那么 getenv 子例程将返回空指针。

返回值

如果存在这样的字符串,那么 getenv 子例程将返回一个指向当前环境中的值的指针。 如果不存在这样的字符串,那么将返回空指针。 getenv 子例程通常不会修改返回的字符串。 但是, putenv 子例程可能会覆盖或更改返回的字符串。 请勿尝试释放返回的指针。 getenv 子例程返回指向用户的环境副本 (静态) 的指针,直到首次调用添加新环境变量的 putenv 子例程为止。 putenv 子例程分配足够大的内存区域,以容纳用户的环境和新变量。 下一次对 getenv 子例程的调用返回一个指向此新分配的空间的指针,该空间不是静态的。 putenv 子例程的后续调用使用 realloc 子例程为新变量留出空间。 不成功完成将返回空指针。