Namespaces
Variants

std::optional<T>:: value_or

From cppreference.net
C++
Utilities library
std::optional
template < class U = std:: remove_cv_t < T > >
constexpr T value_or ( U && default_value ) const & ;
(1) (seit C++17)
template < class U = std:: remove_cv_t < T > >
constexpr T value_or ( U && default_value ) && ;
(2) (seit C++17)

Gibt den enthaltenen Wert zurück, falls * this einen Wert enthält, andernfalls wird default_value zurückgegeben.

1) Wenn std:: is_copy_constructible_v < T > && std:: is_convertible_v < U && , T > false ist, ist das Programm fehlerhaft.
2) Wenn std:: is_move_constructible_v < T > && std:: is_convertible_v < U && , T > false ist, ist das Programm fehlerhaft.

Inhaltsverzeichnis

Parameter

default_value - der Wert, der zurückgegeben werden soll, wenn * this keinen Wert enthält

Rückgabewert

1) has_value ( ) ? ** this : static_cast < T > ( std:: forward < U > ( default_value ) ) ;
2) has_value ( ) ? std :: move ( ** this ) : static_cast < T > ( std:: forward < U > ( default_value ) )

Beispiel

Diesen Code ausführen 
#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';
}

Mögliche Ausgabe: 

/usr/bin/zsh
(none)

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
LWG 3886 C++17 U hat keinen Standard-Template-Argument spezifiziert

Siehe auch

gibt den enthaltenen Wert zurück
(öffentliche Elementfunktion)