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.