std::get(std::pair)

来自cppreference.com
< cpp‎ | utility‎ | pair
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (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++17)
(C++17)
栈踪
 
std::pair
成员函数
非成员函数
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
get
(C++11)
推导指引(C++17)
辅助类
(C++11)
 
定义于头文件 <utility>
(1)
template< std::size_t I, class T1, class T2 >

typename std::tuple_element<I, std::pair<T1,T2> >::type&

    get( std::pair<T1, T2>& p ) noexcept;
(C++11 起)
(C++14 前)
template< std::size_t I, class T1, class T2 >

constexpr std::tuple_element_t<I, std::pair<T1,T2> >&

    get( std::pair<T1, T2>& p ) noexcept;
(C++14 起)
(2)
template< std::size_t I, class T1, class T2 >

const typename std::tuple_element<I, std::pair<T1,T2> >::type&

    get( const std::pair<T1,T2>& p ) noexcept;
(C++11 起)
(C++14 前)
template< std::size_t I, class T1, class T2 >

constexpr const std::tuple_element_t<I, std::pair<T1,T2> >&

    get( const std::pair<T1,T2>& p ) noexcept;
(C++14 起)
(3)
template< std::size_t I, class T1, class T2 >

typename std::tuple_element<I, std::pair<T1,T2> >::type&&

    get( std::pair<T1,T2>&& p ) noexcept;
(C++11 起)
(C++14 前)
template< std::size_t I, class T1, class T2 >

constexpr std::tuple_element_t<I, std::pair<T1,T2> >&&

    get( std::pair<T1,T2>&& p ) noexcept;
(C++14 起)
(4)
template< std::size_t I, class T1, class T2 >

const typename std::tuple_element<I, std::pair<T1,T2> >::type&&

    get( const std::pair<T1,T2>&& p ) noexcept;
(C++11 起)
(C++14 前)
template< std::size_t I, class T1, class T2 >

constexpr const std::tuple_element_t<I, std::pair<T1,T2> >&&

    get( const std::pair<T1,T2>&& p ) noexcept;
(C++14 起)
template <class T, class U>
constexpr T& get(std::pair<T, U>& p) noexcept;
(5) (C++14 起)
template <class T, class U>
constexpr const T& get(const std::pair<T, U>& p) noexcept;
(6) (C++14 起)
template <class T, class U>
constexpr T&& get(std::pair<T, U>&& p) noexcept;
(7) (C++14 起)
template <class T, class U>
constexpr const T&& get(const std::pair<T, U>&& p) noexcept;
(8) (C++14 起)
template <class T, class U>
constexpr T& get(std::pair<U, T>& p) noexcept;
(9) (C++14 起)
template <class T, class U>
constexpr const T& get(const std::pair<U, T>& p) noexcept;
(10) (C++14 起)
template <class T, class U>
constexpr T&& get(std::pair<U, T>&& p) noexcept;
(11) (C++14 起)
template <class T, class U>
constexpr const T&& get(const std::pair<U, T>&& p) noexcept;
(12) (C++14 起)

用仿 tuple 的接口从 pair 提取元素。

若序号 I 不是 0 或 1 则基于范围的重载 (1-4) 无法编译。

若类型 TU 相同则基于类型的重载 (5-12) 无法编译。

参数

p - 要提取内容的 pair

返回值

1-4)I==0 则返回到 p.first 的引用,若 I==1 则返回到 p.second 的引用。
5-8) 返回到 p.first 的引用。
9-12) 返回到 p.second 的引用。

示例

#include <iostream>
#include <utility>
 
int main()
{
    auto p = std::make_pair(1, 3.14);
    std::cout << '(' << std::get<0>(p) << ", " << std::get<1>(p) << ")\n";
    std::cout << '(' << std::get<int>(p) << ", " << std::get<double>(p) << ")\n";
}

输出:

(1, 3.14)
(1, 3.14)

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR 应用于 出版时的行为 正确行为
LWG 2485 C++11 (按索引)
C++14 (按类型)
无对于 const pair&& 的重载 添加重载

参阅

结构化绑定 (C++17) 绑定指定的名字到初始化器的子对象或元组元素
元组式访问指定的元素
(函数模板)
访问 array 的一个元素
(函数模板)
以给定索引或类型(若类型唯一)读取 variant 的值,错误时抛出异常
(函数模板)