Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::expected: un valore o un errore esplicito

std::expected<T, E> contiene esattamente uno di due stati: un valore atteso T oppure un oggetto errore E, senza stato vuoto.

Versione: C++23

Sintassi

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> di <expected> è un’unione discriminata di C++23. Costruisci il successo da un valore T o std::in_place e l’errore con std::unexpected(error) o std::unexpect; has_value() e la conversione esplicita a bool distinguono gli stati.

value() restituisce il valore e, nello stato di errore, lancia std::bad_expected_access<E> contenente l’errore. error() non lancia ma può essere chiamato solo se has_value() è false; anche operator* e operator-> richiedono lo stato valore. L’esempio stampa in sicurezza 7 al successo e missing all’errore.

std::expected::operator bool restituisce lo stato di successo come has_value(). std::expected::operator* e std::expected::operator-> accedono al valore senza controllo e richiedono lo stato di successo; violare questa precondizione causa comportamento indefinito. std::expected::error restituisce un riferimento all’errore e richiede invece lo stato di errore; per un accesso controllato al valore usa value(), che può lanciare.

T deve essere void o un tipo oggetto completo non array che rispetti le esclusioni standard; E deve essere un tipo oggetto non qualificato, non un array né una specializzazione di unexpected. L’oggetto non è mai senza valore, ma copia, move e operazioni monadiche hanno vincoli propri. value_or valuta comunque l’argomento di ripiego prima della chiamata come un normale argomento.

Esempi

#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';
}

Risultato

7 missing

std::expected → 7 missing

Fonti