Namespaces
Variants

std:: swap (std::pair)

From cppreference.net
C++
Utilities library
std::pair
定义于头文件 <utility>
(1)
template < class T1, class T2 >

void swap ( std:: pair < T1,T2 > & x, std:: pair < T1,T2 > & y )

noexcept ( /* 见下文 */ ) ;
(C++11 起)
(C++20 前)
template < class T1, class T2 >

constexpr void swap ( std:: pair < T1,T2 > & x, std:: pair < T1,T2 > & y )

noexcept ( /* 见下文 */ ) ;
(C++20 起)
template < class T1, class T2 >

constexpr void swap ( const std:: pair < T1,T2 > & x, const std:: pair < T1,T2 > & y )

noexcept ( /* 见下文 */ ) ;
(2) (C++23 起)

交换 x 和 y 的内容。等价于 x. swap ( y ) 。

1) 仅当 std:: is_swappable_v < first_type > && std:: is_swappable_v < second_type > 为 true 时，此重载才会参与重载决议。
2) 仅当 std:: is_swappable_v < const first_type > && std:: is_swappable_v < const second_type > 为 true 时，此重载才会参与重载决议。
(since C++17)

目录

参数

x, y - 要交换内容的配对

返回值

(无)

异常

noexcept 规范：
noexcept ( noexcept ( x. swap ( y ) ) )

示例

运行此代码 
#include <iostream>
#include <utility>
int main()
{
    auto p1 = std::make_pair(10, 3.14);
    auto p2 = std::pair(12, 1.23); // CTAD，自 C++17 起
    auto print_p1_p2 = [&](auto msg) {
        std::cout << msg
                  << "p1 = {" << std::get<0>(p1)
                  << ", "     << std::get<1>(p1) << "}, "
                  << "p2 = {" << std::get<0>(p2)
                  << ", "     << std::get<1>(p2) << "}\n";
    };
    print_p1_p2("Before p1.swap(p2): ");
    p1.swap(p2);
    print_p1_p2("After  p1.swap(p2): ");
    std::swap(p1, p2);
    print_p1_p2("After swap(p1, p2): ");
}

输出： 

Before p1.swap(p2): p1 = {10, 3.14}, p2 = {12, 1.23}
After  p1.swap(p2): p1 = {12, 1.23}, p2 = {10, 3.14}
After swap(p1, p2): p1 = {10, 3.14}, p2 = {12, 1.23}

参见

交换两个对象的值
(函数模板)
(C++11)
特化 std::swap 算法
(函数模板)