Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje