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

CKTIS / C++

std::optional::operator*: aceder ao valor contido

`*opt` devolve uma referência para o valor contido. Antes de desreferenciar, verifica se existe um valor: o índice `0` é válido e não indica ausência.

Versão: ISO C++23; implementation support may vary

Sintaxe

// In <optional>, members of std::optional<T>:
constexpr T& operator*() & noexcept;
constexpr const T& operator*() const & noexcept;
constexpr T&& operator*() && noexcept;
constexpr const T&& operator*() const && noexcept;

// Use: *opt, with opt.has_value() == true.

std::optional::operator* está declarado em <optional> e está disponível desde C++17. A expressão *opt devolve uma referência para o objeto guardado num std::optional<T>; a chamada em si não o copia nem o move. Não se trata de um acesso por índice nem da desreferenciação de um ponteiro simples.

Antes de desreferenciar, verifica if (opt) ou opt.has_value(). A conversão contextual para bool testa se existe um valor, não qual é: o índice 0 passa no teste, mas um optional vazio não. Em C++23, desreferenciar um optional vazio provoca comportamento indefinido. Não contes com a implementação para detetar o erro. Se a ausência de valor tiver de provocar uma exceção, usa opt.value(), que lança std::bad_optional_access nesse caso.

As quatro sobrecargas são constexpr e noexcept. Um lvalue dá T&, ou const T& se for const. Um rvalue dá T&&, ou const T&& se for const. Podes alterar o objeto guardado através de T&. Por si só, *std::move(opt) não move o objeto nem esvazia opt.

A referência devolvida não prolonga o tempo de vida do objeto guardado. Não a uses após opt.reset() nem após a destruição de opt. Um optional temporário é normalmente destruído no fim da expressão completa que o criou, mas associar uma referência distinta ao próprio optional pode prolongar o seu tempo de vida.

Exemplos

#include <cstddef>
#include <iostream>
#include <optional>

void print_index(const std::optional<std::size_t>& index)
{
    if (index) {
        std::cout << "index: " << static_cast<unsigned long long>(*index) << '\n';
    } else {
        std::cout << "not found\n";
    }
}

int main()
{
    const std::optional<std::size_t> first{0};
    const std::optional<std::size_t> missing{std::nullopt};
    print_index(first);
    print_index(missing);
}

Resultado

index: 0
not found

`if (index)` reconhece o índice `0` como um valor presente. Com `std::nullopt`, o programa escreve `not found` sem desreferenciar.

Lições relacionadas

  • C++ · Lição 51 · Avançado · Versão: 3

Fontes