CKTIS / C++
std::expected: um valor ou um erro explícito
std::expected<T, E> contém exatamente um de dois estados: um valor esperado T ou um objeto de erro E, sem estado vazio.
Versão: C++23
Sintaxe
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> é uma união discriminada de C++23. Constrói sucesso a partir de um valor T ou std::in_place e falha com std::unexpected(error) ou std::unexpect; has_value() e a conversão explícita para bool distinguem os estados.
value() devolve o valor e, no estado de erro, lança std::bad_expected_access<E> que contém o erro. error() não lança, mas só pode ser chamado se has_value() for false; operator* e operator-> também exigem o estado de valor. O exemplo imprime com segurança 7 no sucesso e missing na falha.
std::expected::operator bool devolve o estado de sucesso tal como has_value(). std::expected::operator* e std::expected::operator-> dão acesso não verificado ao valor e exigem o estado de sucesso; violar essa pré-condição tem comportamento indefinido. std::expected::error devolve uma referência ao erro e exige, inversamente, o estado de erro; para acesso verificado ao valor usa value(), que pode lançar.
T tem de ser void ou um tipo objeto completo não array que cumpra as exclusões padrão; E tem de ser um tipo objeto não qualificado, não array nem especialização de unexpected. O objeto nunca fica sem valor, mas cópia, movimento e operações monádicas têm restrições próprias. value_or ainda avalia o argumento alternativo antes da chamada, como qualquer argumento normal.
Exemplos
#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