Namespaces
Variants

std::deque<T,Allocator>:: swap

From cppreference.net

C++
Containers library
std::deque
Member types
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
void swap ( deque & other ) ;
(C++17まで)
void swap ( deque & other ) noexcept ( /* see below */ ) ;
(C++17から)
(constexprはC++26から)

コンテナの内容を other の内容と交換します。個々の要素に対するムーブ、コピー、スワップ操作は一切呼び出しません。

すべてのイテレータと参照は有効なままです。 end() イテレータは無効化されます。

std:: allocator_traits < allocator_type > :: propagate_on_container_swap :: value が true の場合、アロケータは非メンバー関数 swap に対する修飾なしの呼び出しを使用して交換されます。それ以外の場合、アロケータは交換されません（そして get_allocator ( ) ! = other. get_allocator ( ) の場合、動作は未定義です）。

(C++11以降)

目次

パラメータ

other - 内容を交換するコンテナ

例外

(なし)

(C++17まで)
noexcept 仕様:
noexcept ( std:: allocator_traits < Allocator > :: is_always_equal :: value )
(C++17以降)

計算量

定数。

例

このコードを実行 
#include <iostream>
#include <deque>
template<class Os, class Co>
Os& operator<<(Os& os, const Co& co)
{
    os << '{';
    for (const auto& i : co)
        os << ' ' << i;
    return os << " } ";
}
int main()
{
    std::deque<int> a1{1, 2, 3}, a2{4, 5};
    auto it1 = std::next(a1.begin());
    auto it2 = std::next(a2.begin());
    int& ref1 = a1.front();
    int& ref2 = a2.front();
    std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n';
    a1.swap(a2);
    std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n';
    // swap後もイテレータと参照は元の要素に関連付けられたままであることに注意
    // 例えば、値2の'a1'内の要素を指していたit1は、その要素が'a2'に移動した後も
    // 同じ要素を指し続ける
}

出力: 

{ 1 2 3 } { 4 5 } 2 5 1 4
{ 4 5 } { 1 2 3 } 2 5 1 4

関連項目

std::swap アルゴリズムを特殊化する
(関数テンプレート)