std::optional<T>::value

constexpr T& value() &; constexpr const T& value() const &;	(1)	(since C++17)
constexpr T&& value() &&; constexpr const T&& value() const &&;	(2)	(since C++17)

Если *this содержит значение, возвращает ссылку на это значение.

В противном случае выбрасывает исключение std::bad_optional_access.

Параметры

(нет)

Возвращаемое значение

Ссылка на содержащееся значение.

Исключения

std::bad_optional_access, если *this не содержит значения.

Примечания

Оператор разыменования operator*() не проверяет, содержит ли этот optional значение, что может быть эффективнее, чем value().

Пример

#include <optional>
#include <iostream>
int main()
{
    std::optional<int> opt = {};
 
    try {
        [[maybe_unused]] int n = opt.value();
    } catch(const std::bad_optional_access& e) {
        std::cout << e.what() << '\n';
    }
    try {
        opt.value() = 42;
    } catch(const std::bad_optional_access& e) {
        std::cout << e.what() << '\n';
    }
 
    opt = 43;
    std::cout << *opt << '\n';
 
    opt.value() = 44;
    std::cout << opt.value() << '\n';
}

Вывод:

bad optional access
bad optional access
43
44

См. также

value_or	возвращает содержащееся значение, если оно доступно, в противном случае — другое значение (public member function)
operator->operator*	доступ к содержащемуся значению (public member function)
bad_optional_access (C++17)	исключение, указывающее на проверенный доступ к optional, не содержащему значения (class)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/optional/value