std::tuple_cat

来自cppreference.com
 
C++
 
工具库
通用工具
关系运算符 (C++20 弃用)
 
std::tuple
 
<tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>
在标头 <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 起)
See More

构造 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 的特化，或者实现了 tuple-like 的其他任何类型（例如 std::array 和 std::pair）。

(C++23 起)

如果 /* CTypes */ 中有任何类型无法从以 args 拼接而成的元素序列中对应元素的类型构造，那么行为未定义(C++23 前)程序非良构(C++23 起)。

参数

args - 要拼接的零或更多个元组

返回值

std::tuple 对象，由所有实参元组的所有元素组成，从对于每个独立元素的 std::get<i>(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)
 创建左值引用的 std::tuple，或将元组解包为独立对象
(函数模板) [编辑]
(C++11)
 创建转发引用的 tuple
(函数模板) [编辑]