Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::bad_optional_access — excepción al acceder a un optional vacío

std::bad_optional_access es la excepción que lanza value() cuando std::optional no contiene ningún valor. Distingue este acceso comprobado de los operadores * y ->, que requieren que haya un valor.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#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 es una clase de excepción declarada en <optional> que hereda públicamente de std::exception. Llamar a value() en un std::optional<T> vacío lanza esta excepción; crear un objeto vacío por sí solo no es un error.

Captura la excepción mediante const std::bad_optional_access&. Su método what() devuelve una cadena de diagnóstico terminada en nulo cuyo contenido depende de la implementación. No la compares con un texto fijo en pruebas portables.

Los operadores * y -> requieren que haya un valor: no sustituyen a value() garantizando esta excepción. En C++23, utilizarlos en un objeto vacío provoca comportamiento indefinido. Si se espera que no haya valor, comprueba has_value() o usa el objeto en una condición if; value_or(fallback) devuelve un valor alternativo cuando el objeto está vacío.

El ejemplo llama deliberadamente a value() en un objeto vacío, captura la excepción y luego usa value_or(42). Un mensaje fijo hace que la salida sea predecible. Las fuentes proporcionadas son un borrador de trabajo en evolución, no el texto inmutable de C++23; aquí no se considera que el constexpr que muestran para what() sea una garantía de C++23.

Ejemplos

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

Resultado

empty optional
42

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes