C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 程序支持工具
- std::initializer_list
- 函数对象
- std::hash
- std::pair
- std::tuple
- std::tie
- std::tuple<Types...>::tuple
- std::tuple<Types...>::swap
- std::make_tuple
- std::forward_as_tuple
- std::tuple 的推导指引
- std::tuple<Types...>::operator=
- std::tuple_cat
- operator==,!=,<,<=,>,>=,<=>(std::tuple)
- std::swap(std::tuple)
- std::get(std::tuple)
- std::tuple_size<std::tuple>
- std::tuple_element<std::tuple>
- std::uses_allocator<std::tuple>
- std::ignore
- std::apply
- 库特性测试宏 (C++20)
- std::optional
- std::any
- std::variant
- 格式化库 (C++20)
- std::integer_sequence
- std::exchange
- std::make_from_tuple
- std::launder
- std::to_chars
- std::from_chars
- std::as_const
- std::source_location
- 变参数函数
- std::bitset
- std::cmp_equal, cmp_not_equal, cmp_less, cmp_greater, cmp_less_equal, cmp_greater_equal
- std::in_range
- std::declval
- std::forward
- std::move
- std::move_if_noexcept
- std::chars_format
- std::piecewise_construct_t
- std::piecewise_construct
- std::in_place, std::in_place_type, std::in_place_index, std::in_place_t, std::in_place_type_t, std::in_place_index_t
- 注释
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
位置:首页 > C++ 参考手册 >工具库 >std::tuple > std::tuple<Types...>::tuple
std::tuple<Types...>::tuple
(C++20 起为
constexpr
)(条件性
explicit
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
)(条件性
explicit
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
)(条件性
explicit
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
)(条件性
explicit
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
)(条件性
explicit
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
)(条件性
explicit
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
) tuple( std::allocator_arg_t, const Alloc& a,
(C++20 起为
constexpr
) 构造新的 tuple
。
i
有 Ti
不可从 {} 复制列表初始化才为 explicit 。i
为 true 才参与重载决议。i
,以 std::get<i>(other) 初始化 tuple 的第 i 个元素。sizeof...(Types) == sizeof...(UTypes) 且
std::is_constructible_v<Ti, const Ui&> 对所有 i
为 true 且
sizeof...(Types) != 1 或
Types...
展开成 T
且 UTypes...
展开成 U
时) std::is_convertible_v<const tuple<U>&, T> 、 std::is_constructible_v<T, const tuple<U>&> 与 std::is_same_v<T, U> 均为 false
才参与重载决议。sizeof...(Types) == sizeof...(UTypes) 且
std::is_constructible_v<Ti, Ui&&> 对所有 i
为 true 且
sizeof...(Types) != 1 或
Types...
展开成 T
且 UTypes...
展开成 U
时) std::is_convertible_v<tuple<U>, T> 、 std::is_constructible_v<T, tuple<U>> 与 std::is_same_v<T, U> 均为 false
才参与重载决议。p.first
构造第一个元素,从 p.second
构造第二个元素。other
的对应元素初始化 tuple 的每个元素。a
为额外参数传递给每个 std::uses_allocator<Ui, Alloc>::value 为 true 的对象的构造函数。参数
args | - | 用于初始化 tuple 每个元素的值
|
other | - | 用于初始化 tuple 每个元素的值的 tuple
|
p | - | 用于初始化此 2-tuple 的两个元素的值的 pair
|
a | - | 用于使用分配器构造的分配器 |
注意
条件性 explicit 的构造函数使得可以用列表初始化语法于复制初始化语境构造 tuple :
std::tuple<int, int> foo_tuple() { return {1, -1}; // N4387 前错误 return std::make_tuple(1, -1); // 始终工作 }
注意若列表中某元素不可隐式转换成目标 tuple 中的对应元素,则构造函数变为 explicit 。
using namespace std::chrono; void launch_rocket_at(std::tuple<hours, minutes, seconds>); launch_rocket_at({hours(1), minutes(2), seconds(3)}); // OK launch_rocket_at({1, 2, 3}); // 错误: int 不可隐式转换成 duration launch_rocket_at(std::tuple<hours, minutes, seconds>{1, 2, 3}); // OK
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
N4387 | C++11 | 某些构造函数曾为 explicit ,阻止了有用的行为 | 使大多数构造函数为条件性 explicit |
LWG 2510 | C++11 | 默认构造函数为隐式 | 使之为条件性 explicit |
LWG 3158 | C++11 | 对应默认构造函数的使用分配器构造函数为隐式 | 使之为条件性 explicit |
示例
#include <iostream> #include <string> #include <vector> #include <tuple> #include <memory> // 打印任何大小 tuple 的辅助函数 template<class Tuple, std::size_t N> struct TuplePrinter { static void print(const Tuple& t) { TuplePrinter<Tuple, N-1>::print(t); std::cout << ", " << std::get<N-1>(t); } }; template<class Tuple> struct TuplePrinter<Tuple, 1>{ static void print(const Tuple& t) { std::cout << std::get<0>(t); } }; template<class... Args> void print(const std::tuple<Args...>& t) { std::cout << "("; TuplePrinter<decltype(t), sizeof...(Args)>::print(t); std::cout << ")\n"; } // 辅助函数结束 int main() { std::tuple<int, std::string, double> t1; std::cout << "Value-initialized: "; print(t1); std::tuple<int, std::string, double> t2(42, "Test", -3.14); std::cout << "Initialized with values: "; print(t2); std::tuple<char, std::string, int> t3(t2); std::cout << "Implicitly converted: "; print(t3); std::tuple<int, double> t4(std::make_pair(42, 3.14)); std::cout << "Constructed from a pair"; print(t4); // 给出分配器 (Allocator) my_alloc ,带单参数构造函数 my_alloc(int) // 用 my_alloc(1) 于 vector 中分配 10 个 int std::vector<int, my_alloc> v(10, 1, my_alloc(1)); // 用 my_alloc(2) 于 tuple 中的 vector 分配 10 个 int std::tuple<int, std::vector<int, my_alloc>, double> t5(std::allocator_arg, my_alloc(2), 42, v, -3.14); }
可能的输出:
Value-initialized: (0, , 0) Initialized with values: (42, Test, -3.14) Implicitly converted: (*, Test, -3) Constructed from a pair(42, 3.14)
参阅
创建一个 tuple 对象,其类型根据各实参类型定义 (函数模板) | |
创建左值引用的 tuple ,或将 tuple 解包为独立对象 (函数模板) | |
创建转发引用的 tuple (函数模板) |