Namespaces
Variants

std::swap(std::variant)

ja.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で非推奨)
整数比較関数
(C++20)(C++20)(C++20)    
(C++20)
swap と 型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
共通の語彙型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)



 
 
ヘッダ <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 ではなかったが、必要な操作はC++20で constexpr 化可能 constexpr 化された

関連項目

別の variant と交換する
(公開メンバ関数)