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