Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::bad_optional_access — eccezione per l’accesso a un optional vuoto

std::bad_optional_access è l’eccezione lanciata da value() quando std::optional non contiene un valore. Distingui questo accesso verificato dagli operatori * e ->, che richiedono la presenza di un valore.

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

Sintassi

#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 è una classe di eccezione dichiarata in <optional> che deriva pubblicamente da std::exception. Chiamare value() su un std::optional<T> vuoto lancia questa eccezione; creare un oggetto vuoto, di per sé, non è un errore.

Cattura l’eccezione tramite const std::bad_optional_access&. Il metodo what() restituisce una stringa diagnostica terminata da carattere nullo, il cui contenuto dipende dall’implementazione. Nei test portabili, non confrontarla con un testo fisso.

Gli operatori * e -> richiedono la presenza di un valore: non sostituiscono value() garantendo questa eccezione. In C++23, usarli su un oggetto vuoto causa un comportamento indefinito. Se l’assenza è prevista, controlla has_value() o usa l’oggetto in una condizione if; value_or(fallback) restituisce un valore alternativo quando l’oggetto è vuoto.

L’esempio chiama intenzionalmente value() su un oggetto vuoto, cattura l’eccezione e poi usa value_or(42). Un messaggio fisso rende prevedibile l’output. Le fonti fornite sono una bozza di lavoro in evoluzione, non il testo definitivo di C++23; qui il constexpr mostrato per what() non viene considerato una garanzia di C++23.

Esempi

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

Risultato

empty optional
42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti