Namespaces
Variants

std:: swap (std::variant)

From cppreference.net
C++
Utilities library
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); // ОШИБКА: ~ несовместимые наборы параметров
}

Вывод: 

123 XYZ
XYZ 123

Отчеты о дефектах

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

DR Applied to Behavior as published Correct behavior
P2231R1 C++20 swap не был constexpr в то время как требуемые операции могут быть constexpr в C++20 сделан constexpr

Смотрите также

обменивается с другим variant
(публичная функция-член)