std::getenv

来自cppreference.com
< cpp‎ | utility‎ | program
 
 
工具库
语言支持
类型支持(基本类型、RTTI)
库功能特性测试宏 (C++20)
动态内存管理
程序工具
协程支持 (C++20)
变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)

 
 
在标头 <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 <cstdlib>
#include <iostream>
 
int main()
{
    if (const char* env_p = std::getenv("PATH"))
        std::cout << "您的 PATH 是: " << env_p << '\n';
}

可能的输出:

您的 PATH 是: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games

参阅