Namespaces
Variants

    std::optional<T>::value_or

    Depuis fr.cppreference.net
     
    C++
    Support du compilateur
    Libre et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support du langage
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostic
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque de plages (C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et heure
    Bibliothèque d'entrée/sortie
    Bibliothèque du système de fichiers (C++17)
    Bibliothèque de support de la concurrence (C++11)
    Bibliothèque de contrôle d'exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque d'utilitaires
    Support du langage
    Support des types (types de base, RTTI)
    Macros de test de fonctionnalités de la bibliothèque (C++20)
    Utilitaires de programme
    Fonctions variadiques
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Support des coroutines (C++20)
    Support des contrats (C++26)
    Comparaison à trois voies
    (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)

    Utilitaires généraux
    Opérateurs relationnels (déprécié en C++20)
     
    std::optional
     
    template< class U = std::remove_cv_t<T> > 
constexpr T value_or( U&& default_value ) const&;
    		(1) (depuis C++17) 
    template< class U = std::remove_cv_t<T> > 
constexpr T value_or( U&& default_value ) &&;
    		(2) (depuis C++17)

    Retourne la valeur contenue si *this contient une valeur, sinon retourne default_value.

    1) Si std::is_copy_constructible_v<T> && std::is_convertible_v<U&&, T> est false, le programme est mal formé.
    2) Si std::is_move_constructible_v<T> && std::is_convertible_v<U&&, T> est false, le programme est mal formé.

    Paramètres

    default_value - la valeur à retourner si * this ne contient pas de valeur

    Valeur de retour

    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 ) )

    Exemple

    Exécuter ce code 
    #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';
}

    Sortie possible : 

    /usr/bin/zsh
(none)

    Rapports de défauts

    Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

    DR Appliqué à Comportement publié Comportement corrigé
    LWG 3886 C++17 U ne possède pas d'argument template par défaut spécifié

    Voir aussi

    		retourne la valeur contenue
    (fonction membre publique)