Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::optional::operator*: prístup k uloženej hodnote

`*opt` vracia referenciu na uloženú hodnotu. Pred dereferenciou over, že je hodnota prítomná: index `0` je platný výsledok, nie chýbajúca hodnota.

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

Syntax

// 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* je deklarovaný v hlavičke <optional> a je dostupný od C++17. Výraz *opt vracia referenciu na objekt uložený v std::optional<T>; samotné volanie objekt nekopíruje ani nepresúva. Nejde o prístup cez index ani o dereferenciu obyčajného ukazovateľa.

Pred dereferenciou použi if (opt) alebo opt.has_value(). Kontextová konverzia na bool overuje prítomnosť hodnoty, nie jej obsah: index 0 testom prejde, prázdny optional nie. V C++23 má dereferencia prázdneho optional nedefinované správanie. Nespoliehaj sa na to, že implementácia chybu odhalí. Ak má chýbajúca hodnota vyvolať výnimku, použi opt.value(), ktorá v takom prípade vyhodí std::bad_optional_access.

Všetky štyri preťaženia sú constexpr a noexcept. Pre lvalue dostaneš T&, pre const lvalue const T&. Pre rvalue dostaneš T&&, pre const rvalue const T&&. Cez T& môžeš uložený objekt zmeniť. Samotné *std::move(opt) objekt nepresunie ani opt nevyprázdni.

Vrátená referencia nepredlžuje životnosť uloženého objektu. Nepoužívaj ju po opt.reset() ani po zániku opt. Dočasný optional zvyčajne zanikne na konci úplného výrazu, v ktorom vznikol, ale samostatné naviazanie referencie na samotný optional môže jeho životnosť predĺžiť.

Príklady

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

Výsledok

index: 0
not found

`if (index)` vyhodnotí index `0` ako prítomnú hodnotu. Pri `std::nullopt` program vypíše `not found` bez dereferencie.

Súvisiace lekcie

  • C++ · Lekcia 51 · Pokročilá · Verzia: 3

Zdroje