std:: tuple_cat
|
定义于头文件
<tuple>
|
||
|
template
<
class
...
Tuples
>
std:: tuple < /* CTypes */ ... > tuple_cat ( Tuples && ... args ) ; |
(C++11 起)
(C++14 前) |
|
|
template
<
class
...
Tuples
>
constexpr std:: tuple < /* CTypes */ ... > tuple_cat ( Tuples && ... args ) ; |
(C++14 起)
(C++23 前) |
|
|
template
<
tuple
-
like...
Tuples
>
constexpr std:: tuple < /* CTypes */ ... > tuple_cat ( Tuples && ... args ) ; |
(C++23 起) | |
构造一个包含
args
中所有元组拼接而成的新元组。返回元组的元素类型
/* CTypes */
由按顺序拼接
Tuples
中所有
std::tuple
(C++23 前)
tuple-like
(C++23 起)
类型的元素类型包构成。
|
如果 std:: decay_t < Tuples > ... 中的任何类型不是 std::tuple 的特化,则行为未定义。但实现可以选择支持遵循元组协议的类型(例如 std::array 和 std::pair )。 |
(C++23 前) |
|
类型
std::
decay_t
<
Tuples
>
...
被约束为类元组类型,即要求其中每个类型必须是
std::tuple
的特化,或是满足
|
(C++23 起) |
如果 /* CTypes */ 中的任何类型无法从 args 拼接而成的元素序列中对应元素的类型构造, 则行为未定义 (C++23 前) 则程序非良构 (C++23 起) 。
目录 |
参数
| args | - | 零个或多个要连接的元组 |
返回值
一个由所有参数元组的所有元素组成的 std::tuple 对象,该对象通过为每个独立元素调用 std :: get < j > ( std:: forward < Ti > ( arg ) ) 构造而成。
示例
#include <iostream> #include <string> #include <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<typename... Args, std::enable_if_t<sizeof...(Args) == 0, int> = 0> void print(const std::tuple<Args...>& t) { std::cout << "()\n"; } template<typename... Args, std::enable_if_t<sizeof...(Args) != 0, int> = 0> 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, float> t1(10, "Test", 3.14); int n = 7; auto t2 = std::tuple_cat(t1, std::make_tuple("Foo", "bar"), t1, std::tie(n)); n = 42; print(t2); }
输出:
(10, Test, 3.14, Foo, bar, 10, Test, 3.14, 42)
参见
|
(C++11)
|
创建由实参类型定义的
tuple
对象
(函数模板) |
|
(C++11)
|
创建左值引用组成的
tuple
或将 tuple 解包为独立对象
(函数模板) |
|
(C++11)
|
创建由
转发引用
组成的
tuple
(函数模板) |