Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje