std::experimental::optional<T>::value

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行性扩展 (并行性 TS)

并行性扩展 2 (并行性 TS v2)

并发性扩展 (并发性 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

实验性非 TS

模式匹配

线性代数

std::execution

契约

2D 图形

 

库基础

experimental::optional

experimental::any

experimental::basic_string_view

experimental::sample

experimental::shared_ptr

experimental::weak_ptr

experimental::apply

experimental::invocation_typeexperimental::raw_invocation_type

experimental::search

experimental::default_searcherexperimental::make_default_searcher

experimental::boyer_moore_searcherexperimental::make_boyer_moore_searcher

experimental::boyer_moore_horspool_searcherexperimental::make_boyer_moore_horspool_searcher

类型擦除和多态分配器

类型特征的变量模板

 

std::experimental::optional

成员函数

optional::optional

optional::~optional

optional::operator=

观察器

optional::operator->optional::operator*

optional::operator bool

optional::value

optional::value_or

修改器

optional::emplace

optional::swap

非成员函数

operator==operator!=operator<operator<=operator>operator>=

make_optional

swap

辅助类

hash

nullopt_t

in_place_t

bad_optional_access

辅助对象

nullopt

in_place

 

constexpr T& value() &; constexpr const T & value() const &;	(1)	(库基础 TS)
constexpr T&& value() &&; constexpr const T&& value() const &&;	(2)	(库基础 TS)

返回所包含的值。

1) 等价于 return bool(*this) ? *val : throw bad_optional_access();。

2) 等价于 return bool(*this) ? std::move(*val) : throw bad_optional_access();。

参数

(无)

返回值

对所包含的值的引用。

异常

若 *this 不含值，则抛出 std::experimental::bad_optional_access。

注意

解引用运算符 operator*() 不检查此 optional 是否包含值，这可能比 value() 更高效。

示例

运行此代码

#include <experimental/optional>
#include <iostream>
 
int main()
{
    std::experimental::optional<int> opt = {};
 
    try
    {
        int n = opt.value();
    }
    catch (const std::logic_error& e)
    {
        std::cout << e.what() << '\n';
    }
}

可能的输出

optional<T>::value: not engaged

亦参见

value_or	如果可用，返回包含的值，否则返回另一个值 (public member function)
operator->operator*	访问所包含的值 (public member function)
bad_optional_access (库基础 TS)	当检查式访问不包含值的 optional 时抛出的异常 (class)