C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 程序支持工具
- std::initializer_list
- 函数对象
- std::hash
- std::pair
- std::tuple
- std::optional
- std::hash <std::optional>
- std::optional<T>::operator->, std::optional<T>::operator*
- std::optional<T>::operator=
- std::optional<T>::optional
- std::optional<T>::~optional
- std::optional<T>::operator bool, std::optional<T>::has_value
- std::optional<T>::value
- std::optional<T>::value_or
- std::optional<T>::emplace
- std::optional<T>::swap
- std::optional<T>::reset
- operator==, !=, <, <=, >, >=, <=>(std::optional)
- std::make_optional
- std::swap(std::optional)
- std::optional 的推导指引
- std::nullopt_t
- std::bad_optional_access
- std::nullopt
- std::apply
- 库特性测试宏 (C++20)
- 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++ 关键词
位置：首页 > C++ 参考手册 >工具库 >std::optional > std::optional<T>::value
std::optional<T>::value
| constexpr T& value() &; constexpr const T & value() const &; |
(1) | (C++17 起) |
| constexpr T&& value() &&; constexpr const T&& value() const &&; |
(2) | (C++17 起) |
若 *this 含值，则返回到所含值引用。
否则，抛出 std::bad_optional_access 异常。
参数
（无）
返回值
到所含值的引用。
异常
若 *this 不含值则抛出 std::bad_optional_access 。
注意
解引用运算符 operator*() 不检查此 optional 是否含值，它可能比 value() 更有效率。
示例
运行此代码
#include <optional> #include <iostream> int main() { std::optional<int> opt = {}; try { int n = opt.value(); } catch(const std::exception& e) { std::cout << e.what() << '\n'; } }
可能的输出：
bad optional access
参阅
| 若所含值可用则返回它，否则返回另一个值 (公开成员函数) | |
| 访问所含值 (公开成员函数) | |
| (C++17) |
指示进行了到不含值的 optional 的有检查访问的异常 (类) |