Namespaces
Variants

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

From cppreference.net

C++
Containers library
std::vector
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 ( vector & other ) ;
(C++17まで)
void swap ( vector & other ) noexcept ( /* see below */ ) ;
(C++17から)
(C++20からconstexpr)

コンテナの内容と容量を 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 > :: propagate_on_container_swap :: value
|| std:: allocator_traits < Allocator > :: is_always_equal :: value )
(C++17以降)

計算量

定数。

例

このコードを実行 
#include <iostream>
#include <vector>
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::vector<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

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

DR 適用対象 公開時の動作 正しい動作
LWG 341 C++98 std::vector の容量は交換できなかった 容量も交換される

関連項目

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