Namespaces
Variants

    std::tuple_cat

    ja.cppreference.net 日本語版
     
    C++
    コンパイラサポート
    フリースタンディングとホスト環境
    言語
    標準ライブラリ
    標準ライブラリヘッダ
    名前付き要件
    機能テストマクロ (C++20)
    言語サポートライブラリ
    コンセプトライブラリ (C++20)
    診断ライブラリ
    メモリ管理ライブラリ
    メタプログラミングライブラリ (C++11)
    汎用ユーティリティライブラリ
    コンテナライブラリ
    イテレータライブラリ
    レンジライブラリ (C++20)
    アルゴリズムライブラリ
    文字列ライブラリ
    テキスト処理ライブラリ
    数値ライブラリ
    日付と時間ライブラリ
    入出力ライブラリ
    ファイルシステムライブラリ (C++17)
    並行性サポートライブラリ (C++11)
    実行制御ライブラリ (C++26)
    技術仕様書
    シンボル索引
    外部ライブラリ
     
    ユーティリティライブラリ
    言語サポート
    型サポート (基本型、RTTI)
    ライブラリ機能テストマクロ (C++20)
    プログラムユーティリティ
    可変長引数関数
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    コルーチンサポート (C++20)
    契約サポート (C++26)
    三方比較
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    汎用ユーティリティ
    関係演算子 (C++20で非推奨)
    整数比較関数
    (C++20)(C++20)(C++20)    
    (C++20)
    Swap および 型操作
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    共通語彙型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    std::tuple
     
    ヘッダ <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 */ は、すべての std::tuple(C++23 まで)tuple-like(C++23 以上) 型の Tuples の要素型パックを順に連結したものです。

    std::decay_t<Tuples>... 内のいずれかの型が std::tuple の特殊化でない場合、動作は未定義です。ただし、実装はタプルライクなプロトコルに従う型（std::array や std::pair など）をサポートすることを選択しても構いません。

    		(C++23 まで)

    型 std::decay_t<Tuples>... はタプルライクであるように制約されています。すなわち、各型は std::tuple の特殊化であるか、あるいは std::array や std::pair などのように tuple-like をモデル化する別の型である必要があります。

    		(C++23 以上)

    /* CTypes */ 内のいずれかの型が、args から連結された要素の並びにおける対応する要素の型から構築可能でない場合、動作は未定義となり(C++23 まで)プログラムは ill-formed となり(C++23 以上)ます。

    パラメータ

    args - 連結する0個以上のタプル

    戻り値

    すべての引数タプルの全要素から構成される 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 を作成する
    (関数テンプレート)