C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 程序支持工具
- std::longjmp
- std::_Exit
- EXIT_SUCCESS, EXIT_FAILURE
- std::getenv
- std::signal
- std::sig_atomic_t
- SIG_DFL, SIG_IGN
- std::abort
- std::atexit
- std::exit
- std::at_quick_exit
- std::quick_exit
- setjmp
- std::system
- std::raise
- SIG_ERR
- SIGTERM, SIGSEGV, SIGINT, SIGILL, SIGABRT, SIGFPE
- std::jmp_buf
- std::apply
- 库特性测试宏 (C++20)
- std::initializer_list
- 函数对象
- std::hash
- std::pair
- std::tuple
- std::optional
- std::any
- std::variant
- 格式化库 (C++20)
- std::integer_sequence
- std::exchange
- std::make_from_tuple
- std::launder
- std::to_chars
- std::from_chars
- std::as_const
- std::source_location
- 变参数函数
- std::bitset
- std::cmp_equal, cmp_not_equal, cmp_less, cmp_greater, cmp_less_equal, cmp_greater_equal
- std::in_range
- std::declval
- std::forward
- std::move
- std::move_if_noexcept
- std::chars_format
- std::piecewise_construct_t
- std::piecewise_construct
- std::in_place, std::in_place_type, std::in_place_index, std::in_place_t, std::in_place_type_t, std::in_place_index_t
- 注释
- 类型支持（基本类型、RTTI、类型特性）
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- 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