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 의 용량(capacity)을 교환할 수 없었음 용량도 함께 교환됨

참고 항목

std::swap 알고리즘을 특수화함
(함수 템플릿)