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 ( /* 见下文 */ ) ;
(C++17 起)
(C++20 起为 constexpr)

为 std::variant 重载 std::swap 算法。等效调用 lhs. swap ( rhs ) 。

此重载仅当对 Types... 中的所有 T_i ， std:: is_move_constructible_v < T_i > 与 std:: is_swappable_v < T_i > 均为 true 时参与重载决议。

目录

参数

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++标准。

缺陷报告 应用于 发布时的行为 正确行为
P2231R1 C++20 swap 不是 constexpr ，而所需操作在 C++20 中可以是 constexpr 改为 constexpr

参见

与另一个 variant 交换
(公开成员函数)