Namespaces
Variants

std::optional<T>::operator->, std::optional<T>::operator*

Von de.cppreference.net
 
 
Dienstprogrammbibliothek
Sprachunterstützung
Typunterstützung (Basistypen, RTTI)
Bibliotheks-Feature-Test-Makros (C++20)
Programm-Dienstprogramme
Variadische Funktionen
Koroutinenunterstützung (C++20)
Vertragsunterstützung (C++26)
Dreiseitiger Vergleich
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Allgemeine Dienstprogramme
Relationale Operatoren (veraltet in C++20)
Integer-Vergleichsfunktionen
(C++20)(C++20)(C++20)    
(C++20)
Swap und Typoperationen
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Allgemeine Vokabular-Typen
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)



 
 
constexpr const T* operator->() const noexcept;
(1) (seit C++17)
constexpr T* operator->() noexcept;
(2) (seit C++17)
constexpr const T& operator*() const& noexcept;
(3) (seit C++17)
constexpr T& operator*() & noexcept;
(4) (seit C++17)
constexpr const T&& operator*() const&& noexcept;
(5) (seit C++17)
constexpr T&& operator*() && noexcept;
(6) (seit C++17)

Greift auf den enthaltenen Wert zu.

1,2) Gibt einen Zeiger auf den enthaltenen Wert zurück.
3-6) Gibt eine Referenz auf den enthaltenen Wert zurück.

Falls has_value() falseist, ist das Verhalten undefiniert.

(bis C++26)

Falls has_value() falseist:

  • Wenn die Implementierung gehärtet ist, tritt eine Vertragsverletzung auf.
  • Wenn die Implementierung nicht gehärtet ist, ist das Verhalten undefiniert.
(seit C++26)

Rückgabewert

1,2) val
3,4) * val
5,6) std :: move ( * val  )

Hinweise

Dieser Operator prüft nicht, ob * this einen Wert enthält. Benutzer können dies manuell durch Verwendung von has_value() oder operator bool() überprüfen. Alternativ, falls geprüfter Zugriff benötigt wird, können value() oder value_or() verwendet werden.

Beispiel

#include <iomanip>
#include <iostream>
#include <optional>
#include <string>
int main()
{
    using namespace std::string_literals;
    std::optional<int> opt1{1};
    std::cout << "opt1: " << *opt1 << '\n';
    *opt1 = 2;
    std::cout << "opt1: " << *opt1 << '\n';
    std::optional<std::string> opt2{"abc"s};
    std::cout << "opt2: " << std::quoted(*opt2) << ", size: " << opt2->size() << '\n';
    // Sie können den enthaltenen Wert "entnehmen", indem Sie operator* auf einen Rvalue von optional aufrufen
    auto taken = *std::move(opt2);
    std::cout << "taken: " << std::quoted(taken) << "\n"
                 "opt2: " << std::quoted(*opt2) << ", size: " << opt2->size() << '\n';
}

Ausgabe:

opt1: 1
opt1: 2
opt2: "abc", size: 3
taken: "abc"
opt2: "", size: 0

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
LWG 2762 C++17 operator-> und operator* könnten potenziell werfend sein als noexcept gemacht

Siehe auch

gibt den enthaltenen Wert zurück
(öffentliche Elementfunktion)
gibt den enthaltenen Wert zurück, falls verfügbar, andernfalls einen anderen Wert
(öffentliche Elementfunktion)