Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::unexpected — assinalar explicitamente um resultado de erro

std::unexpected<E> de <expected> encapsula um valor de erro para construir std::expected<T, E> no estado de falha. Permite distinguir um erro de um resultado bem-sucedido, mesmo quando T e E são do mesmo tipo.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::unexpected<E> é um modelo de classe disponível desde C++23 em <expected> que armazena um valor de erro. std::unexpected{error_value} deduz o tipo E. Criar o encapsulamento não lança, por si só, uma exceção, mas o construtor do E armazenado pode lançá-la.

std::expected<T, E> armazena um resultado ou um erro. Passar std::unexpected<E> seleciona o estado de erro; no exemplo, return -1; significaria um resultado int bem-sucedido, enquanto return std::unexpected{-1}; significa uma falha. Esta distinção também funciona quando T e E são idênticos.

std::unexpected<E>::error() permite aceder ao erro armazenado. Para std::expected<T, E>, verifica primeiro o estado: if (result) significa sucesso. Usa *result apenas em caso de sucesso e result.error() apenas em caso de falha. Em C++23, chamar value() sobre um lvalue exige que E possa ser construído por cópia. No estado de erro, result.value() lança std::bad_expected_access<E> se essa exceção for construída com êxito. Ao copiar ou mover o valor de erro do tipo E durante essa construção, pode ser lançada outra exceção em vez de std::bad_expected_access<E>.

O exemplo requer que tanto o compilador como a biblioteca padrão suportem C++23. O código apresentado foi executado sem alterações num ambiente isolado e a saída foi comparada com o resultado indicado. A opção do compilador no repositório não comprova o suporte em tempo de execução no ambiente de produção. O documento de referência fornecido é um projeto em evolução, não uma publicação definitiva de C++23.

Exemplos

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

Resultado

value: 4
error: -1

O código apresentado foi executado sem alterações num ambiente isolado. A saída padrão coincidiu exatamente com o resultado indicado.

Fontes