WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::optional::operator-> — auf ein Element des enthaltenen Werts zugreifen

Mit `->` greifst du auf ein Element des in `std::optional` gespeicherten Werts zu. In C++23 musst du vorher prüfen, ob ein Wert vorhanden ist.

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

Syntax

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-> ist seit C++17 in <optional> verfügbar. Bei opt->member ruft C++ den überladenen Operator auf und wendet anschließend das eingebaute -> auf den zurückgegebenen Zeiger an. Für ein nicht const-qualifiziertes std::optional<T> liefert er T*, für ein const-qualifiziertes const T*. Beide Überladungen sind constexpr und noexcept; keine kopiert den Wert.

In C++23 führt der Aufruf bei einem leeren optional zu undefiniertem Verhalten: Erwarte weder nullptr noch eine Ausnahme. Prüfe mit if (opt) oder opt.has_value() und greife nur zu, solange der Wert noch vorhanden ist. if (opt) nutzt den expliziten operator bool in einer kontextabhängigen Konvertierung und prüft das Vorhandensein, nicht den Wert selbst. Für geprüften Zugriff wirft opt.value() bei fehlendem Wert std::bad_optional_access.

*opt liefert eine Referenz statt eines Zeigers und setzt ebenfalls einen vorhandenen Wert voraus. Der Zeiger aus operator-> übernimmt keinen Besitz und verlängert die Lebensdauer des Werts nicht. Greife damit nicht mehr auf den Wert zu, wenn dessen Lebensdauer beendet ist, etwa nach reset() oder nach der Zerstörung des optional.

Im Beispiel ist fs ein Namensraumalias für std::filesystem. Das & in const std::optional<fs::path>& borrowedpath deklariert eine Lvalue-Referenz auf einen const-qualifizierten Typ: Der Parameter kopiert das optional nicht, und -> wählt die const-Überladung. Auch ein leerer Pfad ist ein vorhandener Wert; path::empty() fragt das Dateisystem nicht ab.

Beispiele

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

Ergebnis

empty path
no value

Der erste Aufruf gibt `empty path` aus, weil ein Wert vorhanden ist, der Pfad aber leer ist. Der zweite gibt `no value` aus und wertet `->` nicht aus.

Zugehörige Lektionen

  • C++ · Lektion 48 · Fortgeschritten · Version: 3

Quellen