std::swap(std::variant)

Определён в заголовке `<variant>`
template< class... Types > void swap( std::variant<Types...>& lhs, std::variant<Types...>& rhs ) noexcept(/* see below */);		(начиная с C++17) (constexpr начиная с C++20)

Перегружает алгоритм std::swap для std::variant. Фактически вызывает lhs.swap(rhs).

Эта перегрузка участвует в разрешении перегрузки, только если std::is_move_constructible_v<T_i> и std::is_swappable_v<T_i> являются true для всех T_i в Types....

Параметры

lhs, rhs - объекты variant, значения которых нужно поменять местами

Возвращаемое значение

(отсутствует)

Исключения

спецификация noexcept:

noexcept(noexcept(lhs.swap(rhs)))

Примечания

Макрос проверки поддержки функции	Значение	Стандарт	Функция
`__cpp_lib_variant`	`202106L`	(C++20) (DR)	Полностью constexpr `std::variant`

Пример

#include <iostream>
#include <string>
#include <variant>

void print(auto const& v, char term = '\n')
{
    std::visit([](auto&& o) { std::cout << o; }, v);
    std::cout << term;
}

int main()
{
    std::variant<int, std::string> v1{123}, v2{"XYZ"};
    print(v1, ' ');
    print(v2);

    std::swap(v1, v2);
    print(v1, ' ');
    print(v2);

    std::variant<double, std::string> v3{3.14};
    // std::swap(v1, v3); // ERROR: ~ inconsistent parameter packs
}

Вывод:

123 XYZ
XYZ 123

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применяется к	Поведение согласно опубликованной версии	Корректное поведение
P2231R1	C++20	`swap` не был constexpr, хотя требуемые операции могут быть constexpr в C++20	сделан constexpr

См. также

swap	меняет местами с другим `variant` (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/variant/swap2