getenv 子例程
用途
返回环境变量的值。
库
标准 C 库 (libc.a)
语法
#include <stdlib.h> char *getenv ( Name)
const char *Name;
const char *Name;
描述
getenv 子例程在环境列表中搜索格式为 Name=Value的字符串。 环境变量有时称为 shell 变量,因为它们经常使用 shell 命令进行设置。
参数
| 项 | 描述 |
|---|---|
| 名称 | 指定环境变量的名称。 如果当前环境中不存在正确格式的字符串,那么 getenv 子例程将返回空指针。 |
返回值
如果存在这样的字符串,那么 getenv 子例程将返回一个指向当前环境中的值的指针。 如果不存在这样的字符串,那么将返回空指针。 getenv 子例程通常不会修改返回的字符串。 但是, putenv 子例程可能会覆盖或更改返回的字符串。 请勿尝试释放返回的指针。 getenv 子例程返回指向用户的环境副本 (静态) 的指针,直到首次调用添加新环境变量的 putenv 子例程为止。 putenv 子例程分配足够大的内存区域,以容纳用户的环境和新变量。 下一次对 getenv 子例程的调用返回一个指向此新分配的空间的指针,该空间不是静态的。 putenv 子例程的后续调用使用 realloc 子例程为新变量留出空间。 不成功完成将返回空指针。