CKTIS / C++
std::unexpected — marcar explícitamente un resultado de error
std::unexpected<E> de <expected> envuelve un valor de error para construir std::expected<T, E> en estado de fallo. Permite distinguir un error de un resultado satisfactorio incluso cuando T y E son del mismo tipo.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}std::unexpected<E> es una plantilla de clase disponible desde C++23 en <expected> que almacena un valor de error. std::unexpected{error_value} deduce el tipo E. Crear el envoltorio no lanza por sí mismo una excepción, pero el constructor del E almacenado sí puede hacerlo.
std::expected<T, E> almacena un resultado o un error. Pasar std::unexpected<E> selecciona el estado de error; en el ejemplo, return -1; significaría un resultado int satisfactorio, mientras que return std::unexpected{-1}; significa un fallo. Esta distinción también funciona cuando T y E son idénticos.
std::unexpected<E>::error() permite acceder al error almacenado. Para std::expected<T, E>, comprueba primero el estado: if (result) significa que la operación ha tenido éxito. Usa *result solo si ha tenido éxito y result.error() solo si ha fallado. En C++23, llamar a value() sobre un lvalue requiere que E se pueda construir por copia. En el estado de error, result.value() lanza std::bad_expected_access<E> si esa excepción se construye correctamente. Al copiar o mover el valor de error de tipo E durante esa construcción, puede lanzarse otra excepción en su lugar.
El ejemplo requiere que tanto el compilador como la biblioteca estándar admitan C++23. El código mostrado se ejecutó sin cambios en un entorno aislado y su salida se cotejó con el resultado indicado. La opción del compilador del repositorio no acredita la compatibilidad en tiempo de ejecución en el entorno de producción. El documento fuente proporcionado es un borrador en evolución, no una publicación definitiva de C++23.
Ejemplos
#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
El código mostrado se ejecutó sin cambios en un entorno aislado. Su salida estándar coincidió exactamente con el resultado indicado.