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

 

<tbody> </tbody>

ヘッダ <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++17
  return std::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) return std::make_tuple(3.8, 'A', "Lisa Simpson");
    if (id == 1) return std::make_tuple(2.9, 'C', "Milhouse Van Houten");
    if (id == 2) return std::make_tuple(1.7, 'D', "Ralph Wiggum");
    throw std::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]