std::tuple

来自cppreference.com
< cpp‎ | utility
定义于头文件 <tuple>
template< class... Types >
class tuple;
(C++11 起)

类模板 std::tuple 是固定大小的异类值汇集。它是 std::pair 的通用化。

(std::is_trivially_destructible_v<Types> && ...)true ,则 tuple 的析构函数是平凡的。

(C++17 起)

目录

[编辑] 模板参数

Types... - tuple 所存储的元素的类型。支持空列表。

[编辑] 成员函数

构造新的 tuple
(公开成员函数)
赋值一个 tuple 的内容给另一个
(公开成员函数)
交换二个 tuple 的内容
(公开成员函数)

[编辑] 非成员函数

创建一个类型由参数类型定义的tuple对象
(函数模板) [编辑]
创建左值引用的一个 tuple ,或解包 tuple 为独立对象
(函数模板) [编辑]
创建右值引用的 tuple
(函数模板) [编辑]
通过连接任意数量的元组来创建一个tuple
(函数模板) [编辑]
tuple 访问指定的元素
(函数模板) [编辑]
按字典顺序比较 tuple 中的值
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]

[编辑] 帮助类

在编译时获得tuple的大小
(类模板特化) [编辑]
获得指定元素的类型
(类模板特化) [编辑]
特化 std::uses_allocator 类型特性
(类模板特化) [编辑]
当使用tie拆开一个tuple时用来跳过元素的占位符
(常量) [编辑]

[编辑] 推导指引(C++17 起)

[编辑] 注意

C++17 前,函数不能用列表初始化返回 tuple :

std::tuple<int, int> foo_tuple() 
{
  return {1, -1};  // C++17 前错误
  return std::make_tuple(1, -1); // 始终有效
}

[编辑] 示例

#include <tuple>
#include <iostream>
#include <string>
#include <stdexcept>
 
std::tuple<double, char, std::string> get_student(int id)
{
    if (id == 0) return std::make_tuple(3.8, 'A', "Lisa Simpson");
    if (id == 1) return std::make_tuple(2.9, 'C', "Milhouse Van Houten");
    if (id == 2) return std::make_tuple(1.7, 'D', "Ralph Wiggum");
    throw std::invalid_argument("id");
}
 
int main()
{
    auto student0 = get_student(0);
    std::cout << "ID: 0, "
              << "GPA: " << std::get<0>(student0) << ", "
              << "grade: " << std::get<1>(student0) << ", "
              << "name: " << std::get<2>(student0) << '\n';
 
    double gpa1;
    char grade1;
    std::string name1;
    std::tie(gpa1, grade1, name1) = get_student(1);
    std::cout << "ID: 1, "
              << "GPA: " << gpa1 << ", "
              << "grade: " << grade1 << ", "
              << "name: " << name1 << '\n';
}

输出:

ID: 0, GPA: 3.8, grade: A, name: Lisa Simpson
ID: 1, GPA: 2.9, grade: C, name: Milhouse Van Houten

[编辑] 引用

  • C++11 standard (ISO/IEC 14882:2011):
  • 20.4 Tuples [tuple]