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

CKTIS / C++

std::optional::operator-> — přístup ke členu obsažené hodnoty

Operátor `->` zpřístupňuje člen hodnoty uložené v `std::optional`. V C++23 před jeho použitím ověř, že je hodnota skutečně přítomná.

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

Syntaxe

In <optional>, std::optional<T> declares:
constexpr T* operator->() noexcept;
constexpr const T* operator->() const noexcept;

Member access: opt->member or opt->method(args...)
C++23 precondition: opt.has_value() is true when operator->() is called.

std::optional::operator-> je od C++17 k dispozici v <optional>. Ve výrazu opt->member C++ zavolá přetížený operátor a pak na vrácený ukazatel použije vestavěný ->. Pro std::optional<T> bez const operátor vrací T*, pro objekt s const vrací const T*. Obě přetížení jsou constexpr a noexcept; ani jedno hodnotu nekopíruje.

V C++23 má volání tohoto operátoru na prázdném objektu optional nedefinované chování: nečekej ani nullptr, ani výjimku. Použij if (opt) nebo opt.has_value() a přistupuj k hodnotě jen tehdy, dokud je přítomná. Podmínka if (opt) používá explicitní operator bool v kontextovém převodu: testuje přítomnost, ne samotnou hodnotu. Pro kontrolovaný přístup použij opt.value(), které při chybějící hodnotě vyvolá std::bad_optional_access.

*opt poskytne referenci namísto ukazatele a rovněž vyžaduje přítomnou hodnotu. Ukazatel z operator-> hodnotu nevlastní ani neprodlužuje její životnost. Nepoužívej ho k přístupu k hodnotě po skončení její životnosti, například po reset() nebo po zániku objektu optional.

V příkladu je fs alias jmenného prostoru std::filesystem. Znak & v const std::optional<fs::path>& borrowedpath deklaruje lvalue referenci na typ s kvalifikátorem const: parametr objekt optional nekopíruje a -> vybere přetížení s const. I prázdná cesta je přítomná hodnota; path::empty() se nedotazuje souborového systému.

Příklady

#include <filesystem>
#include <iostream>
#include <optional>
#include <utility>

namespace fs = std::filesystem;

void describe(const std::optional<fs::path>& borrowedpath)
{
    if (borrowedpath) {
        std::cout << (borrowedpath->empty() ? "empty path\n" : "nonempty path\n");
    } else {
        std::cout << "no value\n";
    }
}

int main()
{
    const std::optional<fs::path> present{std::in_place};
    const std::optional<fs::path> absent;
    describe(present);
    describe(absent);
}

Výsledek

empty path
no value

První volání vypíše `empty path`, protože hodnota je přítomná, ale cesta je prázdná. Druhé vypíše `no value` a `->` nevyhodnotí.

Související lekce

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

Zdroje