Namespaces
Variants

std:: getenv

From cppreference.net
Utilities library
定义于头文件 <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系统中, 环境变量 还可通过全局变量 environ 访问,该变量在 <unistd.h> 中声明为 extern char ** environ ; ,也可通过 main函数 的可选第三参数 envp 访问。

示例

#include <cstdlib>
#include <iostream>
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

参阅

C 文档 关于 getenv