CKTIS / C++
std::optional::operator*: auf den enthaltenen Wert zugreifen
`*opt` liefert eine Referenz auf den enthaltenen Wert. Prüfe vor dem Dereferenzieren, ob ein Wert vorhanden ist: Index `0` ist kein fehlender Wert.
Version: ISO C++23; implementation support may vary
Syntax
// 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* ist in <optional> deklariert und seit C++17 verfügbar. *opt liefert eine Referenz auf das in std::optional<T> gespeicherte Objekt. Der Aufruf selbst kopiert oder verschiebt das Objekt nicht. Es handelt sich weder um einen Indexzugriff noch um das Dereferenzieren eines rohen Zeigers.
Prüfe vor dem Dereferenzieren mit if (opt) oder opt.has_value(), ob ein Wert vorhanden ist. Die kontextabhängige Konvertierung zu bool prüft nur, ob ein Wert vorhanden ist: Index 0 besteht die Prüfung, ein leeres Optional nicht. In C++23 führt das Dereferenzieren eines leeren Optionals zu undefiniertem Verhalten. Verlass dich nicht darauf, dass die Implementierung den Fehler erkennt. Soll ein fehlender Wert eine Ausnahme auslösen, verwende opt.value(): Bei einem leeren Optional wirft es std::bad_optional_access.
Alle vier Überladungen sind constexpr und noexcept. Für ein Lvalue erhältst du T&, für ein const-Lvalue const T&. Für ein Rvalue erhältst du entsprechend T&& oder const T&&. Über T& kannst du das gespeicherte Objekt ändern. *std::move(opt) allein verschiebt das Objekt nicht und leert opt nicht.
Die zurückgegebene Referenz verlängert die Lebensdauer des gespeicherten Objekts nicht. Verwende sie weder nach opt.reset() noch nach der Zerstörung von opt. Ein temporäres Optional wird normalerweise am Ende des vollständigen Ausdrucks zerstört, der es erzeugt hat. Eine separate Bindung einer Referenz an das Optional selbst kann dessen Lebensdauer jedoch verlängern.
Beispiele
#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);
}
Ergebnis
index: 0 not found
`if (index)` erkennt den Index `0` als vorhandenen Wert. Bei `std::nullopt` gibt das Programm `not found` aus, ohne zu dereferenzieren.
Zugehörige Lektionen
- C++ · Lektion 51 · Fortgeschritten · Version: 3