Namespaces
Variants

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

From cppreference.net
C++
Utilities library
std::optional
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.

Wenn has_value() gleich false ist, ist das Verhalten undefiniert.

(bis C++26)

Wenn has_value() gleich false ist:

  • Wenn die Implementierung gehärtet ist, tritt eine Vertragsverletzung auf. Wenn der Vertragsverletzungs-Handler unter "Observe"-Auswertungssemantik zurückkehrt, ist das Verhalten undefiniert.
  • Wenn die Implementierung nicht gehärtet ist, ist das Verhalten undefiniert.
(seit C++26)

Inhaltsverzeichnis

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

Diesen Code ausführen 
#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)