std::getenv
定义于头文件 <cstdlib>
char* getenv( const char* env_var );
于宿主环境(操作系统)提供的环境列表搜索匹配 env_var
所指向的 C 字符串,并返回指向与匹配的列表成员关联的 C 字符串的指针。
不要求此函数为线程安全。到 getenv 的另一调用,还有到 POSIX 函数 setenv() 、 unsetenv() 及 putenv()的调用可能非法化先前调用所返回的指针,或修改从先前调用得到的字符串。(C++11 前)
只要无其他函数修改宿主环境,则此函数线程安全(从多个线程调用它不引入数据竞争)。尤其是若无同步地调用,则 POSIX 函数 setenv() 、 unsetenv() 及 putenv() 会引入数据竞争。(C++11 起)
修改 getenv
所返回的字符串引起未定义行为。
参数
env_var - 标识要查找的环境变量名的空终止字符串
返回值
标识环境变量值的字符串,或若找不到这种字符串则为空指针。
注意
POSIX 系统上,环境变量亦可通过于 <unistd.h>
声明为 extern char **environ; 的全局变量 environ
,及通过可选的 main 函数第三参数 envp
访问。