Namespaces
Variants

std::swap(std::variant)

Материал из ru.cppreference.net
 
 
Библиотека утилит
Поддержка языка
Поддержка типов (основные типы, RTTI)
Макросы проверки возможностей библиотеки (C++20)
Программные утилиты
Функции с переменным числом аргументов
Поддержка корутин (C++20)
Поддержка контрактов (C++26)
Трёхстороннее сравнение
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Общие утилиты
Операторы отношений (устарело в C++20)
 
 
Определён в заголовочном файле <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
(публичная функция-член)