WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::bad_optional_access — Ausnahme beim Zugriff auf ein leeres optional

std::bad_optional_access ist die Ausnahme, die value() auslöst, wenn std::optional keinen Wert enthält. Unterscheide diesen geprüften Zugriff von den Operatoren * und ->, die voraussetzen, dass ein Wert vorhanden ist.

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

Syntax

#include <optional>

try {
    opt.value();
} catch (const std::bad_optional_access& e) {
    // Handle access to an empty optional.
}

// C++23 member signature:
// const char* what() const noexcept override;

std::bad_optional_access ist eine in <optional> deklarierte Ausnahmeklasse, die öffentlich von std::exception abgeleitet ist. Ein Aufruf von value() auf einem leeren std::optional<T> löst diese Ausnahme aus; ein leeres Objekt zu erstellen, ist für sich genommen kein Fehler.

Fange die Ausnahme mit const std::bad_optional_access& ab. Die Methode what() gibt eine nullterminierte Diagnosezeichenkette zurück, deren Inhalt implementierungsabhängig ist. Vergleiche sie in portablen Tests nicht mit einem festgelegten Text.

Die Operatoren * und -> setzen voraus, dass ein Wert vorhanden ist: Sie sind kein Ersatz für value(), der diese Ausnahme garantiert. In C++23 führt ihre Verwendung auf einem leeren Objekt zu undefiniertem Verhalten. Wenn ein fehlender Wert erwartet wird, prüfe has_value() oder verwende das Objekt in einer if-Bedingung; value_or(fallback) gibt einen Ersatzwert zurück, wenn das Objekt leer ist.

Das Beispiel ruft absichtlich value() für ein leeres Objekt auf, fängt die Ausnahme ab und verwendet anschließend value_or(42). Eine feste Meldung sorgt für eine vorhersehbare Ausgabe. Die angegebenen Quellen sind ein fortlaufend bearbeiteter Arbeitsentwurf und kein eingefrorener Wortlaut von C++23; das dort für what() gezeigte constexpr wird hier nicht als C++23-Garantie behandelt.

Beispiele

#include <iostream>
#include <optional>

int main() {
    std::optional<int> number;

    try {
        const int value = number.value();
        std::cout << value << '\n';
    } catch (const std::bad_optional_access&) {
        std::cout << "empty optional\n";
    }

    std::cout << number.value_or(42) << '\n';
}

Ergebnis

empty optional
42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen