std::optional<T>::value_or

template< class U > constexpr T value_or( U&& default_value ) const&;	(1)	(since C++17)
template< class U > constexpr T value_or( U&& default_value ) &&;	(2)	(since 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 <cstdlib>
#include <iostream>
#include <optional>
 
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("(none)") << '\n';
    std::cout << maybe_getenv("MYPWD").value_or("(none)") << '\n';
}

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

/usr/bin/zsh
(none)

См. также

value

возвращает содержимое значения
(публичный член-функция)

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