Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::optional::operator bool — vérifier la présence d’une valeur

`if (opt)` vérifie si un `std::optional` contient une valeur, non si cette valeur est vraie. L’indice `0` et la valeur booléenne `false` comptent tous deux comme des valeurs présentes.

Version : ISO C++23; implementation support may vary

Syntaxe

#include <optional>

// Members of std::optional<T>:
constexpr explicit operator bool() const noexcept;
constexpr bool has_value() const noexcept;

std::optional::operator bool est une fonction membre de conversion explicite de std::optional<T>, dans l’en-tête <optional>. Comme opt.has_value(), elle renvoie true si et seulement si opt contient une valeur. Disponibles depuis C++17, ces deux fonctions s’appellent sur des objets const, ne lèvent pas d’exception (noexcept) et peuvent être utilisées dans des expressions constantes (constexpr) lorsque le contexte le permet.

explicit n’empêche pas la conversion contextuelle en bool : if (opt) et !opt sont donc valides. En revanche, l’initialisation par copie bool present = opt; est incorrecte. Pour stocker le résultat, utilise bool present = opt.has_value(); ou bool present = static_cast<bool>(opt);.

Distingue la présence du contenu. std::optional<int>{0} peut contenir un indice valide dans une numérotation à partir de zéro, et std::optional<bool>{false} contient false. Dans les deux cas, le test de présence donne true. Pour vérifier qu’un indicateur est à la fois présent et vrai, utilise if (flag && *flag). L’opérateur intégré && n’évalue l’opérande droit que si celui de gauche est vrai.

N’utilise *opt ou opt->member que tant que opt contient une valeur. En C++23, accéder ainsi à un optional vide entraîne un comportement indéfini ; opt.value() lève à la place std::bad_optional_access. Le test de présence ne prolonge pas la durée de vie de la valeur contenue : par exemple, reset() la détruit et invalide les références vers celle-ci.

Exemples

#include <iostream>
#include <optional>

int main() {
    const std::optional<int> index{0};
    const std::optional<int> missing;
    const std::optional<bool> flag{false};

    if (index) {
        std::cout << "index: " << *index << '\n';
    }
    if (!missing) {
        std::cout << "index missing\n";
    }
    if (flag) {
        std::cout << "stored flag: " << std::boolalpha << *flag << '\n';
    }
}

Résultat

index: 0
index missing
stored flag: false

La sortie distingue l’indice `0` d’un indice absent. La branche de `if (flag)` est exécutée même si la valeur lue via `*flag` est `false`.

Leçons associées

  • C++ · Leçon 48 · Avancé · Version : 3
  • C++ · Leçon 51 · Avancé · Version : 3

Sources