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

CKTIS / C++

std::expected : une valeur ou une erreur explicite

std::expected<T, E> contient exactement un de deux états : une valeur attendue T ou un objet d’erreur E, sans état vide.

Version : C++23

Syntaxe

template<class T, class E>
class expected {
public:
    constexpr explicit operator bool() const noexcept;
    constexpr T* operator->() noexcept;
    constexpr T& operator*() & noexcept;
    constexpr T& value() &;
    constexpr E& error() & noexcept;
    template<class U> constexpr T value_or(U&& fallback) const &;
};

std::expected<T, E> de <expected> est une union discriminée de C++23. Construisez le succès depuis une valeur T ou std::in_place, et l’échec avec std::unexpected(error) ou std::unexpect ; has_value() et la conversion explicite en bool distinguent les états.

value() renvoie la valeur et, dans l’état d’erreur, lève std::bad_expected_access<E> contenant l’erreur. error() ne lève pas mais ne peut être appelé que si has_value() est false ; operator* et operator-> exigent de même l’état valeur. L’exemple affiche sûrement 7 au succès et missing à l’échec.

std::expected::operator bool renvoie l’état de succès comme has_value(). std::expected::operator* et std::expected::operator-> donnent un accès non vérifié à la valeur et exigent l’état de succès ; violer cette précondition a un comportement indéfini. std::expected::error renvoie une référence vers l’erreur et exige inversement l’état d’erreur ; pour un accès vérifié à la valeur, utilisez value(), qui peut lever une exception.

T doit être void ou un type objet complet non tableau respectant les exclusions de la norme ; E doit être un type objet non qualifié, ni tableau ni spécialisation de unexpected. L’objet n’est jamais sans valeur, mais copie, déplacement et opérations monadiques ont leurs propres contraintes. value_or évalue quand même son argument de repli avant l’appel comme tout argument ordinaire.

Exemples

#include <expected>
#include <iostream>
#include <string>

std::expected<int, std::string> fetch(bool found) {
    if (found) return 7;
    return std::unexpected(std::string{"missing"});
}

int main() {
    const auto good = fetch(true);
    const auto bad = fetch(false);
    std::cout << good.value() << ' ' << bad.error() << '\n';
}

Résultat

7 missing

std::expected → 7 missing

Sources