Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::bad_optional_access — exceção ao aceder a um optional vazio

std::bad_optional_access é a exceção lançada por value() quando std::optional não contém nenhum valor. Distingue este acesso verificado dos operadores * e ->, que exigem a presença de um valor.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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 é uma classe de exceção declarada em <optional> que deriva publicamente de std::exception. Chamar value() num std::optional<T> vazio lança esta exceção; criar um objeto vazio, por si só, não é um erro.

Captura a exceção através de const std::bad_optional_access&. O método what() devolve uma cadeia de diagnóstico terminada em nulo, cujo conteúdo depende da implementação. Não a compares com texto fixo em testes portáveis.

Os operadores * e -> exigem que exista um valor: não substituem value() garantindo esta exceção. Em C++23, utilizá-los num objeto vazio provoca comportamento indefinido. Se for esperada a ausência de valor, verifica has_value() ou usa o objeto numa condição if; value_or(fallback) devolve um valor alternativo quando o objeto está vazio.

O exemplo chama deliberadamente value() num objeto vazio, captura a exceção e, em seguida, usa value_or(42). Uma mensagem fixa torna a saída previsível. As fontes fornecidas são um projeto de trabalho em evolução, não o texto definitivo de C++23; o constexpr aí apresentado para what() não é aqui considerado uma garantia de C++23.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes