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

std::optional<T>::value_or

Материал из cppreference.com
< cpp‎ | utility‎ | optional
 
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (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++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
 
std::optional
Функции-элементы
Наблюдатели
optional::value_or
Монадические операции
Модификаторы
Функции, не являющиеся элементами
Правила вывода
Вспомогательные классы
Вспомогательные объекты
 
template< class U >
constexpr T value_or( U&& default_value ) const&;
(1) (начиная с C++17)
template< class U >
constexpr T value_or( U&& default_value ) &&;
(2) (начиная с C++17)

Возвращает содержащееся значение, если *this имеет значение, иначе возвращает default_value.

1) Эквивалентно bool(*this) ? **this : static_cast<T>(std::forward<U>(default_value))
2) Эквивалентно bool(*this) ? std::move(**this) : static_cast<T>(std::forward<U>(default_value))

Содержание

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

default_value значение, используемое в случае, если *this пусто
Требования к типам
-
T должен соответствовать требованиям CopyConstructible чтобы использовать перегрузку (1).
-
T должен соответствовать требованиям MoveConstructible чтобы использовать перегрузку (2).
-
U&& должен быть преобразуем в T

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

Текущее значение, если *this имеет значение, или default_value иначе.

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

Любое исключение, сгенерированное выбранным конструктором возвращаемого значения T.

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

#include <optional>
#include <iostream>
#include <cstdlib>
 
std::optional<const char*> maybe_getenv(const char* n)
{
    if(const char* x = std::getenv(n))
       return x;
    else
       return {};
}
int main()
{
     std::cout << maybe_getenv("SHELL").value_or("(нет)") << '\n';
     std::cout << maybe_getenv("MYPWD").value_or("(нет)") << '\n';
}

Возможный вывод:

/usr/bin/zsh
(нет)

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

возвращает содержащееся значение
(public функция-элемент) [править]