Namespaces
Variants

    std::optional<T>::value_or

    Aus de.cppreference.net
     
    C++
     
    Hilfsprogrammbibliothek
    Sprachunterstützung
    Typunterstützung (grundlegende Typen, RTTI)
    Bibliotheks-Feature-Test-Makros (C++20)
    Programmhilfsprogramme
    Variate Funktionen
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Koroutinenunterstützung (C++20)
    Vertragsunterstützung (C++26)
    Drei-Wege-Vergleich
    (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)

    Allgemeine Hilfsprogramme
    Relationsoperatoren (veraltet in C++20)
    Ganzzahl-Vergleichsfunktionen
    (C++20)(C++20)(C++20)    
    (C++20)
    Tausch und Typoperationen
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    Gebräuchliche Vokabular-Typen
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    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, wenn *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.

    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)