std::tuple

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

ユーティリティライブラリ

言語サポート 型サポート (基本型、RTTI、型特性) ライブラリの機能テストマクロ (C++20) 動的メモリ管理 プログラムユーティリティ エラー処理 コルーチンサポート(C++20) 可変長引数関数 launder (C++17) initializer_list (C++11) source_location (C++20) 三方比較 (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20) is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

汎用ユーティリティ 日付と時間 関数オブジェクト 書式化ライブラリ(C++20) bitset hash (C++11) integer_sequence (C++14) 関係演算子 (C++20で非推奨) rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>= 整数比較関数 cmp_equalcmp_not_equalcmp_lesscmp_greatercmp_less_thancmp_greater_than (C++20)(C++20)(C++20)(C++20)(C++20)(C++20) in_range (C++20) スワップと型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) forward (C++11) move (C++11) move_if_noexcept (C++11) as_const (C++17) 一般的な語彙の型 pair tuple (C++11) apply (C++17) make_from_tuple (C++17) optional (C++17) any (C++17) variant (C++17) 初等文字列変換 to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

std::tuple

メンバ関数

tuple::tuple

tuple::operator=

tuple::swap

非メンバ関数

make_tuple

tie

forward_as_tuple

tuple_cat

operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)

std::swap

get

推定ガイド(C++17)

ヘルパークラス

tuple_size

tuple_element

uses_allocator

ignore

 

ヘッダ <tuple> で定義
template<class... Types> class tuple;		(C++11以上)

クラステンプレート std::tuple は、異なる型を持つ複数の値の固定サイズのコレクションです。 std::pair を一般化したものと言えます。

(std::is_trivially_destructible_v<Types>&& ...) が true であれば、 tuple のデストラクタもトリビアルです。

(C++17以上)

テンプレート引数

Types...

-

タプルが格納する要素の型。 空リストでも構いません。

メンバ関数

コンストラクタ	新しい tuple を構築します (パブリックメンバ関数)
operator=	tuple の内容を別の tuple に代入します (パブリックメンバ関数)
swap	2つの tuple の内容を交換します (パブリックメンバ関数)

非メンバ関数

make_tuple	引数の型によって定義される型の tuple オブジェクトを作成します (関数テンプレート)
tie	左辺値参照の tuple を作成したり、タプルを個々のオブジェクトに分解したりします (関数テンプレート)
forward_as_tuple	転送参照の tuple を作成します (関数テンプレート)
tuple_cat	任意の数のタプルを連結して新たな tuple を作成します (関数テンプレート)
std::get(std::tuple)	タプルの指定された要素にアクセスします (関数テンプレート)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20で削除)(C++20で削除)(C++20で削除)(C++20で削除)(C++20で削除)(C++20)	タプル内の値を辞書的に比較します (関数テンプレート)
std::swap(std::tuple) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート)

ヘルパークラス

tuple_size	コンパイル時に tuple のサイズを取得します (クラステンプレートの特殊化)
tuple_element	指定された要素の型を取得します (クラステンプレートの特殊化)
std::uses_allocator<std::tuple> (C++11)	std::uses_allocator 型特性の特殊化 (クラステンプレートの特殊化)
ignore	tuple を tie で分解するときに要素をスキップするためのプレースホルダです (定数)

ノート

C++17 以前では、関数の戻り値にリスト初期化を使うことはできませんでした。

std::tuple<int, int> foo_tuple(){return{1, -1};// Error until C++17returnstd::make_tuple(1, -1);// Always works}

例

Run this code

#include <tuple>#include <iostream>#include <string>#include <stdexcept>   std::tuple<double, char, std::string> get_student(int id){if(id ==0)returnstd::make_tuple(3.8, 'A', "Lisa Simpson");if(id ==1)returnstd::make_tuple(2.9, 'C', "Milhouse Van Houten");if(id ==2)returnstd::make_tuple(1.7, 'D', "Ralph Wiggum");throwstd::invalid_argument("id");}   int main(){auto student0 = get_student(0);std::cout<<"ID: 0, "<<"GPA: "<< std::get<0>(student0)<<", "<<"grade: "<< std::get<1>(student0)<<", "<<"name: "<< std::get<2>(student0)<<'\n';   double gpa1;char grade1;std::string name1;std::tie(gpa1, grade1, name1)= get_student(1);std::cout<<"ID: 1, "<<"GPA: "<< gpa1 <<", "<<"grade: "<< grade1 <<", "<<"name: "<< name1 <<'\n';   // C++17 structured binding:auto[ gpa2, grade2, name2 ]= get_student(2);std::cout<<"ID: 2, "<<"GPA: "<< gpa2 <<", "<<"grade: "<< grade2 <<", "<<"name: "<< name2 <<'\n';}

出力:

ID: 0, GPA: 3.8, grade: A, name: Lisa Simpson ID: 1, GPA: 2.9, grade: C, name: Milhouse Van Houten ID: 2, GPA: 1.7, grade: D, name: Ralph Wiggum

参考文献

• C++11 standard (ISO/IEC 14882:2011):

• 20.4 Tuples [tuple]