Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::unexpected — indicare esplicitamente un risultato di errore

std::unexpected<E> di <expected> racchiude un valore di errore per costruire std::expected<T, E> nello stato di errore. Permette di distinguere un errore da un risultato riuscito anche quando T ed E sono dello stesso tipo.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}

std::unexpected<E> è un modello di classe disponibile da C++23 in <expected> che memorizza un valore di errore. std::unexpected{error_value} deduce il tipo E. La creazione del wrapper non genera di per sé un’eccezione, ma il costruttore del tipo E memorizzato può farlo.

std::expected<T, E> memorizza un risultato oppure un errore. Passare std::unexpected<E> seleziona lo stato di errore; nell’esempio, return -1; indicherebbe un risultato int riuscito, mentre return std::unexpected{-1}; indica un errore. Questa distinzione vale anche quando T ed E sono identici.

std::unexpected<E>::error() consente di accedere all’errore memorizzato. Con std::expected<T, E>, controlla prima lo stato: if (result) significa che l’operazione è riuscita. Usa *result solo in caso di successo e result.error() solo in caso di errore. In C++23, chiamare value() su un lvalue richiede che E sia costruibile per copia. Nello stato di errore, result.value() lancia std::bad_expected_access<E> se la costruzione di tale eccezione va a buon fine. Durante la costruzione dell’eccezione, la copia o lo spostamento del valore di errore di tipo E può invece lanciare un’eccezione diversa.

L’esempio richiede il supporto a C++23 sia nel compilatore sia nella libreria standard. Il codice mostrato è stato eseguito senza modifiche in un ambiente isolato e l’output è stato confrontato con il risultato indicato. L’opzione del compilatore nel repository non attesta il supporto in fase di esecuzione nell’ambiente di produzione. Il documento sorgente fornito è una bozza in evoluzione, non una pubblicazione C++23 definitiva.

Esempi

#include <expected>
#include <initializer_list>
#include <iostream>

std::expected<int, int> half(int n) {
    if (n % 2 != 0) {
        return std::unexpected{-1};
    }
    return n / 2;
}

int main() {
    for (int n : {8, 7}) {
        auto result = half(n);
        if (result) {
            std::cout << "value: " << *result << '\n';
        } else {
            std::cout << "error: " << result.error() << '\n';
        }
    }
}

Risultato

value: 4
error: -1

Il codice mostrato è stato eseguito senza modifiche in un ambiente isolato. L’output standard corrispondeva esattamente al risultato indicato.

Fonti