Пространства имён
Варианты
Действия

std::optional<T>::value

Материал из cppreference.com
< cpp‎ | utility‎ | optional
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
(C++20)
(C++26)
(C++11)
(C++20)
Трёхстороннее сравнение (C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(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++20)
(C++14)
(C++11)
(C++23)
(C++11)
(C++23)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++11)
(C++17)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
(C++17)
 
std::optional
Функции-элементы
Наблюдатели
optional::value
Монадические операции
(C++23)
(C++23)
(C++23)
Модификаторы
Функции, не являющиеся элементами
(C++20)
Правила вывода
Вспомогательные классы
Вспомогательные объекты
 
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.

Содержание

[править] Параметры

(нет)

[править] Возвращаемое значение

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

[править] Исключения

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

[править] Смотрите также

 возвращает содержащееся значение, если доступно, иначе другое значение
(public функция-элемент) [править]
получает доступ к содержащемуся значению
(public функция-элемент) [править]
(C++17)
 исключение, указывающее на доступ на проверку к optional, не содержащему значения
(класс) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/utility/optional/value&oldid=59294»