CKTIS / C++
std::expected: hodnota alebo explicitná chyba
std::expected<T, E> obsahuje práve jeden z dvoch stavov: očakávanú hodnotu T alebo chybový objekt E, bez prázdneho stavu.
Verzia: C++23
Syntax
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> z <expected> je diskriminovaná únia C++23. Úspech vytvorte z hodnoty T alebo std::in_place, chybu pomocou std::unexpected(error) či std::unexpect; has_value() a explicitný prevod na bool stavy rozlišujú.
value() vracia hodnotu a v chybovom stave vyhodí std::bad_expected_access<E> obsahujúci chybu. error() nevyhadzuje, ale smie sa volať iba pri false z has_value(); aj operator* a operator-> vyžadujú stav hodnoty. Príklad bezpečne vypíše 7 pri úspechu a missing pri chybe.
std::expected::operator bool vracia stav úspechu rovnako ako has_value(). std::expected::operator* a std::expected::operator-> poskytujú nekontrolovaný prístup k hodnote a vyžadujú stav úspechu; porušenie tohto predpokladu vedie k nedefinovanému správaniu. std::expected::error vracia odkaz na chybu a naopak vyžaduje stav chyby; na kontrolovaný prístup k hodnote použite potenciálne vyhadzujúce value().
T musí byť void alebo úplný nepoľový objektový typ spĺňajúci štandardné výnimky; E musí byť nekvalifikovaný objektový typ, nie pole ani špecializácia unexpected. Objekt nikdy nie je bez hodnoty, ale kopírovanie, presun a monadické operácie majú vlastné typové podmienky. value_or vyhodnotí náhradný argument pred volaním ako bežný argument funkcie.
Príklady
#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';
}
Výsledok
7 missing
std::expected → 7 missing