CKTIS / C++
std::expected: hodnota nebo explicitní chyba
std::expected<T, E> obsahuje právě jeden ze dvou stavů: očekávanou hodnotu T nebo chybový objekt E, bez prázdného stavu.
Verze: C++23
Syntaxe
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á unie C++23. Úspěch vytvořte z hodnoty T nebo std::in_place, chybu pomocí std::unexpected(error) či std::unexpect; has_value() a explicitní převod na bool stavy rozlišují.
value() vrací hodnotu a v chybovém stavu vyhodí std::bad_expected_access<E> obsahující chybu. error() nevyhazuje, ale smí se volat jen při false z has_value(); také operator* a operator-> vyžadují stav hodnoty. Příklad bezpečně vypíše 7 při úspěchu a missing při chybě.
std::expected::operator bool vrací stav úspěchu stejně jako has_value(). std::expected::operator* a std::expected::operator-> poskytují nekontrolovaný přístup k hodnotě a vyžadují stav úspěchu; porušení tohoto předpokladu vede k nedefinovanému chování. std::expected::error vrací odkaz na chybu a naopak vyžaduje stav chyby; pro kontrolovaný přístup k hodnotě použijte potenciálně vyhazující value().
T musí být void nebo úplný nepolový objektový typ splňující standardní výjimky; E musí být nekvalifikovaný objektový typ, ne pole ani specializace unexpected. Objekt nikdy není bez hodnoty, ale kopie, přesun a monadické operace mají vlastní typové podmínky. value_or vyhodnotí náhradní argument před voláním jako běžný argument funkce.
Pří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ýsledek
7 missing
std::expected → 7 missing