Namespaces
Variants

    std::get(std::tuple)

    来自 zh.cppreference.net
     
    C++
     
    工具库
    通用工具
    关系运算符 (C++20 中弃用)
    整数比较函数
    (C++20)(C++20)(C++20)    
    (C++20)
    交换 与 类型操作
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    常用词汇类型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    std::tuple
     
    定义于头文件 <tuple> 
    template< std::size_t I, class... Types >
typename std::tuple_element<I, std::tuple<Types...>>::type&
    get( std::tuple<Types...>& t ) noexcept;
    		(1) (C++11 起)
    (自 C++14 起 constexpr)    		 
    template< std::size_t I, class... Types >
typename std::tuple_element<I, std::tuple<Types...>>::type&&
    get( std::tuple<Types...>&& t ) noexcept;
    		(2) (C++11 起)
    (自 C++14 起 constexpr)    		 
    template< std::size_t I, class... Types >
const typename std::tuple_element<I, std::tuple<Types...>>::type&
    get( const std::tuple<Types...>& t ) noexcept;
    		(3) (C++11 起)
    (自 C++14 起 constexpr)    		 
    template< std::size_t I, class... Types >
const typename std::tuple_element<I, std::tuple<Types...>>::type&&
    get( const std::tuple<Types...>&& t ) noexcept;
    		(4) (C++11 起)
    (自 C++14 起 constexpr)    		 
    template< class T, class... Types >
constexpr T& get( std::tuple<Types...>& t ) noexcept;
    		(5) (C++14 起) 
    template< class T, class... Types >
constexpr T&& get( std::tuple<Types...>&& t ) noexcept;
    		(6) (C++14 起) 
    template< class T, class... Types >
constexpr const T& get( const std::tuple<Types...>& t ) noexcept;
    		(7) (C++14 起) 
    template< class T, class... Types >
constexpr const T&& get( const std::tuple<Types...>&& t ) noexcept;
    		(8) (C++14 起)
    1-4) 提取元组中第 I个元素。I 必须是 [0, sizeof...(Types)) 范围内的整数值。
    5-8) 提取元组 t 中类型为 T 的元素。除非元组中恰好有该类型的一个元素，否则编译失败。

    参数

    t - 待提取内容的元组

    返回值

    对 t 中选定元素的引用。

    注释

    功能测试 宏 值 标准 功能
    __cpp_lib_tuples_by_type 201304L (C++14) 按类型访问元组 ( 5-8 )

    示例

    运行此代码 
    #include <cassert>
#include <iostream>
#include <string>
#include <tuple>
int main()
{
    auto x = std::make_tuple(1, "Foo", 3.14);
    // 基于索引的访问
    std::cout << "( " << std::get<0>(x)
              << ", " << std::get<1>(x)
              << ", " << std::get<2>(x)
              << " )\n";
    // 基于类型的访问（自 C++14 起）
    std::cout << "( " << std::get<int>(x)
              << ", " << std::get<const char*>(x)
              << ", " << std::get<double>(x)
              << " )\n";
    const std::tuple<int, const int, double, double> y(1, 2, 6.9, 9.6);
    const int& i1 = std::get<int>(y); // 正确：无歧义
    assert(i1 == 1);
    const int& i2 = std::get<const int>(y); // 正确：无歧义
    assert(i2 == 2);
    // const double& d = std::get<double>(y); // 错误：格式不正确（存在歧义）
    // 注意：可使用 std::tie 和结构化绑定
    // 将元组解包为独立对象
}

    输出： 

    ( 1, Foo, 3.14 )
( 1, Foo, 3.14 )

    缺陷报告

    下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

    缺陷报告 适用范围 发布时行为 修正后行为
    LWG 2485 C++11（按索引）
    C++14（按类型）     		缺少针对 const tuple && 的重载版本 已添加这些重载版本（ ( 4 ) 和 ( 8 ) ）

    参见

    (C++11)
    		访问 array 的元素
    (函数模板)
    (C++11)
    		访问 pair 的元素
    (函数模板)
    (C++17)
    		通过索引或类型（若类型唯一）读取 variant 的值，错误时抛出异常
    (函数模板)
    (C++20)
    		从 std::ranges::subrange 获取迭代器或哨兵
    (函数模板)
    (C++26)
    		从 std::complex 获取实部或虚部的引用
    (函数模板)
    (C++11)
    		创建左值引用的 tuple 或将 tuple 解包为独立对象
    (函数模板)
    结构化绑定 (C++17) 将指定名称绑定到初始化器的子对象或 tuple 元素