Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::bad_optional_access — výjimka při přístupu k prázdnému optional

std::bad_optional_access je výjimka, kterou vyvolá value(), když std::optional neobsahuje žádnou hodnotu. Odlišujte tento kontrolovaný přístup od operátorů * a ->, které vyžadují přítomnost hodnoty.

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

Syntaxe

#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 je třída výjimky deklarovaná v <optional>, která veřejně dědí z std::exception. Volání value() na prázdném std::optional<T> vyvolá tuto výjimku; samotné vytvoření prázdného objektu není chyba.

Výjimku zachyťte pomocí const std::bad_optional_access&. Metoda what() vrací diagnostický řetězec zakončený nulovým znakem, jehož obsah závisí na implementaci. V přenositelných testech jej neporovnávejte s pevným textem.

Operátory * a -> vyžadují, aby byla přítomna hodnota: nejsou náhradou za value(), která zaručuje tuto výjimku. V C++23 jejich použití na prázdném objektu způsobuje nedefinované chování. Pokud očekáváte chybějící hodnotu, zkontrolujte has_value() nebo použijte objekt v podmínce if; value_or(fallback) vrátí náhradní hodnotu, když je objekt prázdný.

Příklad záměrně volá value() na prázdném objektu, zachytí výjimku a poté použije value_or(42). Pevná zpráva zajišťuje předvídatelný výstup. Uvedené zdroje jsou průběžně upravovaný pracovní návrh, nikoli neměnné znění C++23; constexpr uvedené u what() zde není považováno za záruku C++23.

Příklady

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

Výsledek

empty optional
42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje