Namespaces
Variants

std:: tuple_cat

From cppreference.net
Utilities library
ヘッダーで定義 <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以降) 型の要素型パックを順に連結することで形成される。

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 - 連結する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を個々のオブジェクトに展開する
(関数テンプレート)
転送参照 tuple を作成する
(関数テンプレート)