Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::optional::operator*: dostęp do przechowywanej wartości

Wyrażenie `*opt` zwraca referencję do przechowywanej wartości. Najpierw upewnij się, że `opt` zawiera wartość: indeks `0` nie oznacza jej braku.

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

Składnia

// 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* z nagłówka <optional> jest dostępny od C++17. Wyrażenie *opt zwraca referencję do obiektu przechowywanego w std::optional<T>; samo wywołanie go nie kopiuje ani nie przenosi. Nie jest to indeksowanie ani dereferencja surowego wskaźnika.

Najpierw sprawdź if (opt) lub opt.has_value(). Kontekstowa konwersja do bool sprawdza obecność wartości, a nie jej treść: indeks 0 przechodzi ten test, lecz pusty optional nie. W C++23 dereferencja pustego optional powoduje niezdefiniowane zachowanie. Nie zakładaj, że implementacja wykryje błąd. Jeśli brak wartości ma skutkować wyjątkiem, użyj opt.value(), które w takim przypadku zgłasza std::bad_optional_access.

Wszystkie cztery przeciążenia są constexpr i noexcept. Dla l-wartości wynikiem jest T&, a dla l-wartości const — const T&. Dla r-wartości wynikiem jest odpowiednio T&& lub const T&&. Przez T& można zmienić przechowywany obiekt; samo *std::move(opt) go nie przenosi ani nie opróżnia opt.

Uzyskana referencja nie przedłuża życia przechowywanego obiektu. Nie używaj jej po opt.reset() ani po zniszczeniu opt. Tymczasowy optional jest zwykle niszczony na końcu pełnego wyrażenia, w którym powstał, ale odrębne związanie referencji z samym optional może przedłużyć jego życie.

Przykłady

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

Wynik

index: 0
not found

`if (index)` przyjmuje indeks `0` jako obecną wartość. Dla `std::nullopt` program wypisuje `not found` bez dereferencji.

Powiązane lekcje

  • C++ · Lekcja 51 · Zaawansowany · Wersja: 3

Źródła