Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::expected: un valor o un error explícito

std::expected<T, E> contiene exactamente uno de dos estados: un valor esperado T o un objeto de error E, sin estado vacío.

Versión: C++23

Sintaxis

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> de <expected> es una unión discriminada de C++23. Construye el éxito desde un valor T o std::in_place y el fallo con std::unexpected(error) o std::unexpect; has_value() y la conversión explícita a bool distinguen los estados.

value() devuelve el valor y, en estado de error, lanza std::bad_expected_access<E> que contiene el error. error() no lanza, pero solo puede llamarse si has_value() es false; operator* y operator-> también exigen el estado de valor. El ejemplo imprime de forma segura 7 al acertar y missing al fallar.

std::expected::operator bool devuelve el estado de éxito igual que has_value(). std::expected::operator* y std::expected::operator-> acceden al valor sin comprobar y exigen el estado de éxito; incumplir esa precondición tiene comportamiento indefinido. std::expected::error devuelve una referencia al error y, a la inversa, exige el estado de error; para acceso comprobado al valor usa value(), que puede lanzar.

T debe ser void o un tipo objeto completo no array que cumpla las exclusiones estándar; E debe ser un tipo objeto no cualificado, ni array ni especialización de unexpected. El objeto nunca queda sin valor, pero copia, movimiento y operaciones monádicas tienen restricciones propias. value_or evalúa su argumento alternativo antes de la llamada como cualquier argumento normal.

Ejemplos

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

Resultado

7 missing

std::expected → 7 missing

Fuentes