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