Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::optional::operator*: accedere al valore contenuto

`*opt` restituisce un riferimento al valore contenuto. Verifica che il valore sia presente prima di accedervi: l’indice `0` non indica un valore mancante.

Versione: ISO C++23; implementation support may vary

Sintassi

// 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* è dichiarato in <optional> ed è disponibile da C++17. L’espressione *opt restituisce un riferimento all’oggetto conservato in uno std::optional<T>; la chiamata non copia né sposta l’oggetto. Non è un accesso per indice né la dereferenziazione di un puntatore grezzo.

Prima di dereferenziare, controlla if (opt) oppure opt.has_value(). La conversione contestuale a bool verifica la presenza del valore, non il suo contenuto: l’indice 0 supera il controllo, un optional vuoto no. In C++23, dereferenziare un optional vuoto causa un comportamento indefinito. Non contare sul fatto che l’implementazione rilevi l’errore. Se l’assenza deve generare un’eccezione, usa opt.value(), che in quel caso lancia std::bad_optional_access.

Tutti e quattro gli overload sono constexpr e noexcept. Un lvalue dà T&, oppure const T& se è const. Un rvalue dà T&&, oppure const T&& se è const. Puoi modificare l’oggetto contenuto tramite T&; da solo, *std::move(opt) non sposta l’oggetto e non svuota opt.

Il riferimento restituito non prolunga la durata di vita dell’oggetto contenuto. Non usarlo dopo opt.reset() o dopo la distruzione di opt. Un optional temporaneo viene normalmente distrutto al termine dell’espressione completa che lo ha creato, ma legare un riferimento distinto all’optional stesso può prolungarne la durata di vita.

Esempi

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

Risultato

index: 0
not found

`if (index)` riconosce l’indice `0` come presente. Con `std::nullopt`, il programma stampa `not found` senza dereferenziare.

Lezioni correlate

  • C++ · Lezione 51 · Avanzato · Versione: 3

Fonti