std::optional<T>:: operator=
|
optional
&
operator
=
(
std::
nullopt_t
)
noexcept
;
|
(1) |
(seit C++17)
(constexpr seit C++20) |
|
constexpr
optional
&
operator
=
(
const
optional
&
other
)
;
|
(2) | (seit C++17) |
|
constexpr
optional
&
operator
=
( optional && other ) noexcept ( /* siehe unten */ ) ; |
(3) | (seit C++17) |
|
template
<
class
U
>
optional & operator = ( const optional < U > & other ) ; |
(4) |
(seit C++17)
(constexpr seit C++20) |
|
template
<
class
U
>
optional & operator = ( optional < U > && other ) ; |
(5) |
(seit C++17)
(constexpr seit C++20) |
|
template
<
class
U
=
std::
remove_cv_t
<
T
>
>
optional & operator = ( U && value ) ; |
(6) |
(seit C++17)
(constexpr seit C++20) |
Ersetzt den Inhalt von * this durch den Inhalt von other .
val
-
>
T
::
~T
(
)
auf, um den enthaltenen Wert zu zerstören; andernfalls keine Wirkung.
*
this
enthält nach diesem Aufruf keinen Wert.
| Effekt | * this enthält einen Wert | * this enthält keinen Wert |
|---|---|---|
| other enthält einen Wert |
|
|
| other enthält keinen Wert |
zerstört den enthaltenen Wert durch Aufruf von
val
-
>
T
::
~T
(
)
|
kein Effekt |
-
Die folgenden 12 Werte sind alle
false
[1]
:
- std:: is_constructible_v < T, std:: optional < U > & >
- std:: is_constructible_v < T, const std:: optional < U > & >
- std:: is_constructible_v < T, std:: optional < U > && >
- std:: is_constructible_v < T, const std:: optional < U > && >
- std:: is_convertible_v < std:: optional < U > & , T >
- std:: is_convertible_v < const std:: optional < U > & , T >
- std:: is_convertible_v < std:: optional < U > && , T >
- std:: is_convertible_v < const std:: optional < U > && , T >
- std:: is_assignable_v < T & , std:: optional < U > & >
- std:: is_assignable_v < T & , const std:: optional < U > & >
- std:: is_assignable_v < T & , std:: optional < U > && >
- std:: is_assignable_v < T & , const std:: optional < U > && >
- Für Überladung (4) , std:: is_constructible_v < T, const U & > und std:: is_assignable_v < T & , const U & > sind beide true .
- Für Überladung (5) , std:: is_constructible_v < T, U > und std:: is_assignable_v < T & , U > sind beide true .
- std:: decay_t < U > (bis C++20) std:: remove_cvref_t < U > (seit C++20) nicht std:: optional < T > ist.
- std:: is_constructible_v < T, U > true ist.
- std:: is_assignable_v < T & , U > true ist.
-
Mindestens eine der folgenden Bedingungen erfüllt ist:
-
Tkein Skalartyp ist. -
std::
decay_t
<
U
>
nicht
Tist.
-
-
↑
Mit anderen Worten,
Tist nicht konstruierbar, konvertierbar oder zuweisbar von irgendeinem Ausdruck des Typs (möglicherweise const-qualifiziert) std:: optional < U >
Inhaltsverzeichnis |
Parameter
| other | - |
ein weiteres
optional
Objekt, dessen enthaltene Wert zugewiesen werden soll
|
| value | - | Wert, der dem enthaltenen Wert zugewiesen werden soll |
Rückgabewert
* this
Exceptions
T
geworfen wird. Wenn eine Ausnahme geworfen wird, bleibt der Initialisierungszustand von
*
this
(und von
other
im Fall von
(
2-5
)
) unverändert, d.h. wenn das Objekt einen Wert enthielt, enthält es weiterhin einen Wert und umgekehrt. Der Inhalt von
value
und die enthaltenen Werte von
*
this
und
other
hängen von den Ausnahmesicherheitsgarantien der Operation ab, von der die Ausnahme stammt (Copy-Konstruktor, Move-Zuweisung, etc.).
std:: is_nothrow_move_constructible_v < T > )
Hinweise
Ein optionales Objekt
op
kann mit beiden Ausdrücken in ein leeres Optional umgewandelt werden:
op
=
{
}
;
und
op
=
nullopt
;
. Der erste Ausdruck konstruiert ein leeres
optional
-Objekt mit
{
}
und weist es
op
zu.
| Feature-Test Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_optional
|
202106L
|
(C++20)
(DR20) |
Vollständig constexpr ( 1 ) , ( 4-6 ) |
Beispiel
#include <iostream> #include <optional> int main() { std::optional<const char*> s1 = "abc", s2; // Konstruktor s2 = s1; // Zuweisung s1 = "def"; // Zerfallende Zuweisung (U = char[4], T = const char*) std::cout << *s2 << ' ' << *s1 << '\n'; }
Ausgabe:
abc def
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrigiertes Verhalten |
|---|---|---|---|
| LWG 3886 | C++17 |
das Standard-Template-Argument von Überladung
(
6
)
war
T
|
geändert zu std:: remove_cv_t < T > |
| P0602R4 | C++17 |
Kopier-/Verschiebezuweisungsoperator könnte nicht trivial sein
selbst wenn zugrundeliegende Operationen trivial sind |
muss Trivialität propagieren |
| P2231R1 | C++20 | Überladungen ( 1,4-6 ) waren nicht constexpr | gemacht constexpr |
Siehe auch
|
Konstruiert den enthaltenen Wert direkt
(öffentliche Member-Funktion) |