C++ 参考手册

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 访问。

示例

运行此代码
#include <iostream>
#include <cstdlib>
 
int main()
{
    if(const char* env_p = std::getenv("PATH"))
        std::cout << "Your PATH is: " << env_p << '\n';
}

可能的输出： 

Your PATH is: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games

参阅