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