std::swap(std::variant)

来自cppreference.com
< cpp‎ | utility‎ | variant
 
 
工具库
语言支持
类型支持(基本类型、RTTI)
库功能特性测试宏 (C++20)
动态内存管理
程序工具
协程支持 (C++20)
变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)

 
 
在标头 <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)

此重载只有在 std::is_move_constructible_v<T_i>std::is_swappable_v<T_i> 对于所有 Types... 中的 T_i 皆为 true 时才会参与重载决议。

参数

lhs, rhs - 要交换值的 variant 对象

返回值

(无)

异常

noexcept 说明:  
noexcept(noexcept(lhs.swap(rhs)))

注解

功能特性测试 标准 功能特性
__cpp_lib_variant 202106L (C++20)
(DR)
完全 constexprstd::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 交换
(公开成员函数)