Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::optional::operator-> — dostęp do składowych przechowywanej wartości

Operator `->` daje dostęp do składowych wartości wewnątrz `std::optional`. W C++23 przed jego użyciem trzeba sprawdzić, czy wartość jest obecna.

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

Składnia

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-> jest dostępny od C++17 w <optional>. Wyrażenie opt->member wywołuje przeciążony operator, a następnie stosuje wbudowane -> do otrzymanego wskaźnika. Operator zwraca T* dla obiektu std::optional<T> bez const oraz const T* dla obiektu z const. Oba przeciążenia są constexpr i noexcept; żadne nie kopiuje wartości.

W C++23 wywołanie operatora na pustym optional ma niezdefiniowane zachowanie: nie można oczekiwać ani nullptr, ani wyjątku. Użyj if (opt) lub opt.has_value() i sięgaj po wartość tylko wtedy, gdy nadal jest obecna. Warunek if (opt) korzysta z jawnego operator bool w konwersji kontekstowej: sprawdza obecność wartości, a nie samą wartość. Dostęp sprawdzany zapewnia opt.value(), które w razie braku wartości zgłasza std::bad_optional_access.

*opt daje referencję zamiast wskaźnika i również wymaga obecności wartości. Wskaźnik zwrócony przez operator-> nie przejmuje własności i nie przedłuża czasu życia wartości. Nie używaj go do dostępu do wartości po zakończeniu jej życia, na przykład po reset() lub zniszczeniu obiektu optional.

W przykładzie fs to alias przestrzeni nazw std::filesystem. Zapis const std::optional<fs::path>& borrowedpath deklaruje referencję l-wartościową do obiektu traktowanego jako const: parametr nie kopiuje tego obiektu optional, a -> wybiera przeciążenie const. Pusta ścieżka to nadal obecna wartość; path::empty() nie sprawdza systemu plików.

Przykłady

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

Wynik

empty path
no value

Pierwsze wywołanie wypisuje `empty path`, ponieważ wartość jest obecna, ale ścieżka jest pusta. Drugie wypisuje `no value` i nie wykonuje `->`.

Powiązane lekcje

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

Źródła