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 */
は、全ての
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 | - | 連結する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
を作成する
(関数テンプレート) |