std:: tuple

クラステンプレート std::tuple は、異種の値の固定サイズコレクションです。これは std::pair の一般化です。

Types 内のすべての Ti について std:: is_trivially_destructible < Ti > :: value が true の場合、 std::tuple のデストラクタはトリビアルです。

プログラムが explicit または partial 特殊化の std::tuple を宣言する場合、そのプログラムは診断なしに不適格となる。

テンプレートパラメータ

メンバー関数

非メンバー関数

ヘルパーコンセプト

ヘルパークラス

ヘルパー特殊化

この std::enable_nonlocking_formatter_optimization の特殊化は、 std::print および std::println が tuple オブジェクトを出力する際、各要素型がこれを有効化している場合に効率的な実装を可能にします。

推論ガイド (C++17以降)

注記

タプルの「形状」――そのサイズ、要素の型、およびそれらの型の順序――は型シグネチャの一部であるため、これらはすべてコンパイル時に利用可能でなければならず、他のコンパイル時情報にのみ依存できます。これは、タプルに対する多くの条件付き操作――特に条件付き先頭追加/末尾追加およびフィルタ――は、条件がコンパイル時に評価可能な場合にのみ実行可能であることを意味します。例えば、 std :: tuple < int , double , int > が与えられた場合、型によるフィルタリング――例えば std :: tuple < int , int > を返す――は可能ですが、各要素が正であるかどうかによるフィルタリング（これはタプルの実行時値に応じて異なる型シグネチャを持つことになる）は、すべての要素自体が constexpr でない限り不可能です。

回避策として、 std:: optional のタプルを使用する方法がありますが、実行時情報に基づいてサイズを調整する方法は依然として存在しません。

N4387 （C++11に対する欠陥報告として適用）が導入されるまで、関数はcopy-list-initializationを使用してタプルを返すことができませんでした：

std::tuple<int, int> foo_tuple()
{
    return {1, -1};  // N4387までエラー
    return std::tuple<int, int>{1, -1}; // 常に動作
    return std::make_tuple(1, -1); // 常に動作
}

例

#include <iostream>
#include <stdexcept>
#include <string>
#include <tuple>
std::tuple<double, char, std::string> get_student(int id)
{
    switch (id)
    {
        case 0: return {3.8, 'A', "Lisa Simpson"};
        case 1: return {2.9, 'C', "Milhouse Van Houten"};
        case 2: return {1.7, 'D', "Ralph Wiggum"};
        case 3: return {0.6, 'F', "Bart Simpson"};
    }
    throw std::invalid_argument("id");
}
int main()
{
    const 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';
    const auto student1 = get_student(1);
    std::cout << "ID: 1, "
              << "GPA: " << std::get<double>(student1) << ", "
              << "grade: " << std::get<char>(student1) << ", "
              << "name: " << std::get<std::string>(student1) << '\n';
    double gpa2;
    char grade2;
    std::string name2;
    std::tie(gpa2, grade2, name2) = get_student(2);
    std::cout << "ID: 2, "
              << "GPA: " << gpa2 << ", "
              << "grade: " << grade2 << ", "
              << "name: " << name2 << '\n';
    // C++17 structured binding:
    const auto [gpa3, grade3, name3] = get_student(3);
    std::cout << "ID: 3, "
              << "GPA: " << gpa3 << ", "
              << "grade: " << grade3 << ", "
              << "name: " << name3 << '\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
ID: 3, GPA: 0.6, grade: F, name: Bart Simpson

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

参考文献

関連項目