WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::unexpected — einen Fehlerzustand ausdrücklich kennzeichnen

std::unexpected<E> aus <expected> verpackt einen Fehlerwert, um std::expected<T, E> im Fehlerzustand zu konstruieren. Damit lässt sich ein Fehler von einem erfolgreichen Ergebnis unterscheiden, selbst wenn T und E denselben Typ haben.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <expected>
std::unexpected<E> error{error_value};
std::unexpected{error_value}
std::expected<T, E>{std::unexpected<E>{error_value}}

std::unexpected<E> ist eine seit C++23 in <expected> verfügbare Klassenvorlage, die einen Fehlerwert speichert. std::unexpected{error_value} leitet den Typ E ab. Das Erzeugen des Wrappers löst selbst keine Ausnahme aus, der Konstruktor des gespeicherten E kann jedoch eine auslösen.

std::expected<T, E> speichert entweder ein Ergebnis oder einen Fehler. Die Übergabe von std::unexpected<E> wählt den Fehlerzustand aus; im Beispiel würde return -1; ein erfolgreiches Ergebnis vom Typ int bedeuten, während return std::unexpected{-1}; einen Fehler bedeutet. Diese Unterscheidung funktioniert auch dann, wenn T und E identisch sind.

Mit std::unexpected<E>::error() lässt sich auf den gespeicherten Fehler zugreifen. Prüfe bei std::expected<T, E> zuerst den Zustand: if (result) bedeutet Erfolg. Verwende *result nur bei Erfolg und result.error() nur bei einem Fehler. In C++23 setzt ein Aufruf von value() auf einem Lvalue voraus, dass E durch Kopieren konstruiert werden kann. Im Fehlerzustand wirft result.value() die Ausnahme std::bad_expected_access<E>, sofern diese erfolgreich konstruiert wird. Beim Kopieren oder Verschieben des Fehlerwerts vom Typ E während der Konstruktion kann stattdessen eine andere Ausnahme ausgelöst werden.

Das Beispiel erfordert C++23-Unterstützung sowohl im Compiler als auch in der Standardbibliothek. Der gezeigte Code wurde unverändert in einer isolierten Umgebung ausgeführt und seine Ausgabe mit dem angegebenen Ergebnis abgeglichen. Das Compiler-Flag im Repository bestätigt keine Laufzeitunterstützung in der Produktionsumgebung. Das bereitgestellte Quelldokument ist ein Entwurf, der laufend weiterentwickelt wird, und keine unveränderliche C++23-Veröffentlichung.

Beispiele

#include <expected>
#include <initializer_list>
#include <iostream>

std::expected<int, int> half(int n) {
    if (n % 2 != 0) {
        return std::unexpected{-1};
    }
    return n / 2;
}

int main() {
    for (int n : {8, 7}) {
        auto result = half(n);
        if (result) {
            std::cout << "value: " << *result << '\n';
        } else {
            std::cout << "error: " << result.error() << '\n';
        }
    }
}

Ergebnis

value: 4
error: -1

Der gezeigte Code wurde unverändert in einer isolierten Umgebung ausgeführt. Seine Standardausgabe stimmte exakt mit dem angegebenen Ergebnis überein.

Quellen