WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::expected: Wert oder expliziter Fehler

std::expected<T, E> enthält genau einen von zwei Zuständen: einen erwarteten T-Wert oder ein E-Fehlerobjekt, ohne leeren Zustand.

Version: 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> aus <expected> ist eine diskriminierte Union von C++23. Erfolg entsteht aus einem T-Wert oder std::in_place, Fehler mit std::unexpected(error) oder std::unexpect; has_value() und die explizite Umwandlung nach bool unterscheiden die Zustände.

value() liefert den Wert und wirft im Fehlerzustand std::bad_expected_access<E> mit dem Fehler. error() wirft nicht, darf aber nur bei falschem has_value() aufgerufen werden; ebenso verlangen operator* und operator-> den Wertzustand. Das Beispiel gibt sicher 7 für Erfolg und missing für Fehler aus.

std::expected::operator bool liefert wie has_value() den Erfolgszustand. std::expected::operator* und std::expected::operator-> greifen ungeprüft auf den Wert zu und verlangen den Erfolgszustand; eine Verletzung dieser Vorbedingung ist undefiniertes Verhalten. std::expected::error liefert eine Fehlerreferenz und verlangt umgekehrt den Fehlerzustand; für geprüften Wertzugriff dient das potenziell werfende value().

T muss void oder ein vollständiger Nicht-Array-Objekttyp unter den Standardausschlüssen sein; E muss ein unqualifizierter Objekttyp sein, kein Array und keine unexpected-Spezialisierung. Das Objekt ist nie wertlos, doch Kopier-, Move- und monadische Operationen haben eigene Typbedingungen. value_or wertet sein Ersatzargument wie ein gewöhnliches Funktionsargument schon vor dem Aufruf aus.

Beispiele

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

Ergebnis

7 missing

std::expected → 7 missing

Quellen