std::tuple

 

C++

言語

コンセプト

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

ストリングスライブラリ

コンテナライブラリ

アルゴリズムライブラリ

イテレータライブラリ

ニューメリックスライブラリ

入力/出力ライブラリ

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

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

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

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

 

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

型支援 (基本型、実行時型情報、型特性)

動的なメモリ管理

エラー処理

プログラムユーティリティ

可変個引数関数

日付と時刻

関数オブジェクト

initializer_list (C++11)

bitset

hash (C++11)

比較演算子

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

ペアとタプル

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

フォワード、スワップ、およびムーブ

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

std::tuple

メンバ関数

tuple::tuple

tuple::operator=

tuple::swap

非メンバ関数

make_tuple

tie

forward_as_tuple

None

operator= operator!= operator< operator<= operator> operator>=

std::swap

get

ヘルパクラス

tuple_size

tuple_element

uses_allocator

ignore

 

Defined in header <tuple>
template< class... Types > class tuple;		(C++11およびそれ以降)

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

メンバ関数

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

非メンバ関数

make_tuple	引数の型で定義されるtuple型のオブジェクトを作成します (関数テンプレート)
tie	左辺値参照のtupleを作成します。tupleを個々のオブジェクトに分解することにも応用できます。 (関数テンプレート)
forward_as_tuple	右辺値参照を内包するtupleを作成します。 (関数テンプレート)
tuple_cat	任意の数のタプルを連結して新たなtupleを作成します。 (関数テンプレート)
std::get(std::tuple)	タプルの指定された要素へのアクセサです。 (関数テンプレート)
operator== operator!= operator< operator<= operator> operator>=	辞書式順序に基いてタプルに内包される値を比較します。 (関数テンプレート)
std::swap(std::tuple) (C++11)	std::swapアルゴリズムのテンプレート特殊化です。 (関数テンプレート)

ヘルパークラス

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

例

このコードを実行します

#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';
}

出力:

ID: 0, GPA: 3.8, grade: A, name: Lisa Simpson
ID: 1, GPA: 2.9, grade: C, name: Milhouse Van Houten