std::variant::swap
From cppreference.com
| void swap( variant& rhs ) noexcept(/* see below */); |
(1) | (since C++17) |
Swaps two variant objects.
- if both
*thisandrhsare valueless by exception, does nothing - otherwise, if both
*thisandrhshold the same alternative, calls swap(std::get<i>(*this), std:get<i>(rhs)) whereiisindex(). If an exception is thrown, the state of the values depends on the exception safety of the swap function called. - otherwise, exchanges values of
rhsand*this. If an exception is thrown, the state of*thisandrhsdepends on exception safety of variant's move constructor.
The behavior is undefined unless lvalues of type T_i are Swappable and std::is_move_constructible_v<T_i> is true for all T_i in Types....
Contents |
[edit] Parameters
| rhs | - | a variant object to swap with |
[edit] Return value
(none)
[edit] Exceptions
If this->index() == rhs.index(), may throw any exception thrown by swap(std::get<i>(*this), std::get<i>(rhs)) with i being index().
Otherwise, may throw any exception thrown by the move constructors of the alternatives currently held by *this and rhs.
noexcept specification:
noexcept(((std::is_nothrow_move_constructible_v<Types> &&
std::is_nothrow_swappable_v<Types>) && ...))
std::is_nothrow_swappable_v<Types>) && ...))
[edit] Example
| This section is incomplete Reason: no example |