KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::expected: een waarde of een expliciete fout

std::expected<T, E> bevat precies één van twee toestanden: een verwachte T-waarde of een E-foutobject, zonder lege toestand.

Versie: 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> uit <expected> is een gediscrimineerde union van C++23. Construeer succes uit een T-waarde of std::in_place, en falen met std::unexpected(error) of std::unexpect; has_value() en expliciete conversie naar bool onderscheiden de toestanden.

value() retourneert de waarde en werpt in de fouttoestand std::bad_expected_access<E> met de fout. error() werpt niet maar mag alleen worden aangeroepen wanneer has_value() false is; ook operator* en operator-> vereisen de waardetoestand. Het voorbeeld print veilig 7 bij succes en missing bij falen.

std::expected::operator bool retourneert net als has_value() de successtatus. std::expected::operator* en std::expected::operator-> geven ongecontroleerde waardetoegang en vereisen de successtatus; schending van die voorwaarde geeft ongedefinieerd gedrag. std::expected::error retourneert een verwijzing naar de fout en vereist juist de foutstatus; gebruik het mogelijk werpende value() voor gecontroleerde waardetoegang.

T moet void of een volledig niet-array-objecttype zijn dat aan de standaarduitsluitingen voldoet; E moet een ongekwalificeerd objecttype zijn, geen array of unexpected-specialisatie. Het object is nooit waardeloos, maar kopieer-, move- en monadische operaties hebben eigen typevoorwaarden. value_or evalueert het terugvalargument zoals een gewoon functieargument al vóór de aanroep.

Voorbeelden

#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';
}

Resultaat

7 missing

std::expected → 7 missing

Bronnen