Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::optional::operator*: přístup k uložené hodnotě

`*opt` vrací referenci na uloženou hodnotu. Před dereferencí ověř, že je hodnota přítomná: index `0` je platný výsledek, nikoli chybějící hodnota.

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

Syntaxe

// 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 deklarován v hlavičce <optional> a je dostupný od C++17. Výraz *opt vrací referenci na objekt uložený v std::optional<T>; samotné volání objekt nekopíruje ani nepřesouvá. Nejde o přístup pomocí indexu ani o dereferenci obyčejného ukazatele.

Před dereferencí použij if (opt) nebo opt.has_value(). Kontextový převod na bool ověřuje přítomnost hodnoty, nikoli její obsah: index 0 testem projde, prázdný optional nikoli. V C++23 má dereference prázdného optional nedefinované chování. Nespoléhej se na to, že implementace chybu odhalí. Pokud má chybějící hodnota vyvolat výjimku, použij opt.value(), která v takovém případě vyhodí std::bad_optional_access.

Všechny čtyři přetížené varianty jsou constexpr a noexcept. Pro lvalue dostaneš T&, pro const lvalue const T&. Pro rvalue dostaneš T&&, pro const rvalue const T&&. Přes T& můžeš uložený objekt změnit. Samotné *std::move(opt) objekt nepřesune ani opt nevyprázdní.

Vrácená reference neprodlužuje životnost uloženého objektu. Nepoužívej ji po opt.reset() ani po zániku opt. Dočasný optional obvykle zaniká na konci úplného výrazu, ve kterém vznikl, ale samostatná vazba reference na samotný optional může jeho životnost prodloužit.

Pří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ýsledek

index: 0
not found

`if (index)` vyhodnotí index `0` jako přítomnou hodnotu. Pro `std::nullopt` program vypíše `not found` bez dereference.

Související lekce

  • C++ · Lekce 51 · Pokročilá · Verze: 3

Zdroje