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.