std::expected<T,E>:: swap
|
Modèle primaire
|
||
|
constexpr
void
swap
(
expected
&
other
)
noexcept
(
/* voir ci-dessous */
)
;
|
(1) | (depuis C++23) |
|
void
Spécialisation partielle
|
||
|
constexpr
void
swap
(
expected
&
other
)
noexcept
(
/* voir ci-dessous */
)
;
|
(2) | (depuis C++23) |
Échange le contenu avec celui de other .
Valeur de
has_value()
|
Valeur de other. has_value ( ) | |
|---|---|---|
| true | false | |
| true |
using
std::
swap
;
swap (
val
, rhs.
val
)
;
|
voir ci-dessous |
| false | other. swap ( * this ) ; |
using
std::
swap
;
swap (
unex
, rhs.
unex
)
;
|
has_value()
is
true
and
autre.
has_value
(
)
is
false
, equivalent to:
// Cas 1 : les constructions par déplacement des valeurs inattendues sont non-lançantes :
// « other.unex » sera restauré si la construction de « other.val » échoue
if
constexpr
(
std::
is_nothrow_move_constructible_v
<
E
>
)
{
E temp
(
std
::
move
(
other.
unex
)
)
;
std::
destroy_at
(
std::
addressof
(
other.
unex
)
)
;
try
{
std::
construct_at
(
std::
addressof
(
other.
val
)
, std
::
move
(
val
)
)
;
// peut lever une exception
std::
destroy_at
(
std::
addressof
(
val
)
)
;
std::
construct_at
(
std::
addressof
(
unex
)
, std
::
move
(
temp
)
)
;
}
catch
(
...
)
{
std::
construct_at
(
std::
addressof
(
other.
unex
)
, std
::
move
(
temp
)
)
;
throw
;
}
}
// Cas 2 : les constructions par déplacement des valeurs attendues sont non-lançantes :
// « this->val » sera restauré si la construction de « this->unex » échoue
else
{
T temp
(
std
::
move
(
val
)
)
;
std::
destroy_at
(
std::
addressof
(
val
)
)
;
try
{
std::
construct_at
(
std::
addressof
(
unex
)
, std
::
move
(
other.
unex
)
)
;
// peut lever une exception
std::
destroy_at
(
std::
addressof
(
other.
unex
)
)
;
std::
construct_at
(
std::
addressof
(
other.
val
)
, std
::
move
(
temp
)
)
;
}
catch
(
...
)
{
std::
construct_at
(
std::
addressof
(
val
)
, std
::
move
(
temp
)
)
;
throw
;
}
}
has_val
=
false
;
rhs.
has_val
=
true
;
- std:: is_swappable_v < T >
- std:: is_swappable_v < E >
- std:: is_move_constructible_v < T > && std:: is_move_constructible_v < E >
- std:: is_nothrow_move_constructible_v < T > || std:: is_nothrow_move_constructible_v < E >
Valeur de
has_value()
|
Valeur de other. has_value ( ) | |
|---|---|---|
| true | false | |
| true |
using
std::
swap
;
swap (
val
, rhs.
val
)
;
|
std::
construct_at
(
std::
addressof
(
unex
)
,
std
::
move
(
rhs.
unex
)
)
;
std:: destroy_at ( std:: addressof ( rhs.
unex
)
)
;
has_val
=
false
;
rhs.
has_val
=
true
;
|
| false | other. swap ( * this ) ; |
using
std::
swap
;
swap (
unex
, rhs.
unex
)
;
|
Table des matières |
Paramètres
| autre | - |
l'objet
expected
avec lequel échanger le contenu
|
Exceptions
std::
is_nothrow_move_constructible_v
<
T
>
&&
std::
is_nothrow_swappable_v
<
T
>
&&
std::
is_nothrow_move_constructible_v
<
E
>
&&
std::
is_nothrow_swappable_v
<
E
>
std::
is_nothrow_move_constructible_v
<
E
>
&&
std::
is_nothrow_swappable_v
<
E
>
Exemple
#include <expected> #include <iostream> #include <string_view> using Ex = std::expected<std::string, int>; void show(const Ex& ex1, const Ex& ex2, std::string_view term = "\n") { for (int i{}; i != 2; ++i) { std::cout << (i ? "ex2" : "ex1"); if (const Ex& ex = (i ? ex2 : ex1); ex.has_value()) std::cout << ".value() = " << *ex << " "; else std::cout << ".error() = " << ex.error() << " "; } std::cout << term; } int main() { Ex ex1("\N{CAT FACE}"); Ex ex2{"\N{GREEN HEART}"}; show(ex1, ex2, "après ex1.swap(ex2):\n"); ex1.swap(ex2); show(ex1, ex2, "\n\n"); ex2 = std::unexpected(13); show(ex1, ex2, "après ex1.swap(ex2):\n"); ex1.swap(ex2); show(ex1, ex2, "\n\n"); ex2 = std::unexpected(37); show(ex1, ex2, "après ex1.swap(ex2):\n"); ex1.swap(ex2); show(ex1, ex2); }
Sortie :
ex1.value() = 🐱 ex2.value() = 💚 après ex1.swap(ex2): ex1.value() = 💚 ex2.value() = 🐱 ex1.value() = 💚 ex2.error() = 13 après ex1.swap(ex2): ex1.error() = 13 ex2.value() = 💚 ex1.error() = 13 ex2.error() = 37 après ex1.swap(ex2): ex1.error() = 37 ex2.error() = 13
Voir aussi
|
(C++23)
|
spécialise l'algorithme
std::swap
(fonction) |