std::tuple_cat

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

工具库

类型支持（基本类型、 RTTI 、类型特性）
动态内存管理
错误处理
程序工具
变参数函数
库特性测试宏
日期和时间
函数对象
格式化库 (C++20)
initializer_list (C++11)
source_location (C++20)
bitset
hash (C++11)
integer_sequence (C++14)
关系运算符 (C++20 中弃用)
rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=
比较 (C++20)
three_way_comparablethree_way_comparable_with
strong_ordering weak_ordering partial_ordering common_comparison_category compare_three_way_result compare_three_way	strong_order weak_order partial_order compare_strong_order_fallback compare_weak_order_fallback compare_partial_order_fallback	is_eqis_neqis_ltis_lteqis_gtis_gteq
共用词汇类型
pair tuple (C++11) apply (C++17) make_from_tuple (C++17)	optional (C++17) any (C++17) variant (C++17)
swap 、 forward 与 move
swap
exchange (C++14)
forward (C++11)
move (C++11)
move_if_noexcept (C++11)
初等字符串转换
to_chars (C++17)
from_chars (C++17)
chars_format (C++17)
类型运算
declval (C++11)
as_const (C++17)
launder (C++17)

 

std::tuple

成员函数

tuple::tuple

tuple::operator=

tuple::swap

非成员函数

make_tuple

tie

forward_as_tuple

tuple_cat

operator==operator!=operator<operator<=operator>operator>=

std::swap

get

推导指引(C++17)

辅助类

tuple_size

tuple_element

uses_allocator

ignore

 

定义于头文件 <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 起)

构造所有 args 中的 tuple 所连接成 tuple 。

若 std::decay_t<Tuples>... 中的任何类型不是 std::tuple 的特化则行为未定义。然而，实现可以选择支持遵循仿 tuple 协议的类型（例如 std::array 与 std::pair ）。

参数

args

-

要连接的零或更多 tuple

返回值

std::tuple 对象，由所有参数 tuple 的所有元素组成，对于每个独立元素构造自 std::get<i>(std::forward<Ti>(arg)) 。

示例

运行此代码

#include <iostream>
#include <tuple>
#include <string>
 
// 打印任何大小 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, 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 = 10;
    print(t2);
}

输出：

(10, Test, 3.14, Foo, bar, 10, Test, 3.14, 10)

参阅

make_tuple	创建一个 tuple 对象，其类型根据各实参类型定义 (函数模板)
tie	创建左值引用的 tuple，或将 tuple 解包为独立对象 (函数模板)
forward_as_tuple	创建转发引用的 tuple (函数模板)