Namespaces
Variants

std::tie

ja.cppreference.net より
 
 
ユーティリティライブラリ
言語サポート
型サポート (基本型、RTTI)
ライブラリ機能テストマクロ (C++20)
プログラムユーティリティ
可変長引数関数
コルーチンサポート (C++20)
契約サポート (C++26)
三方比較
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

一般ユーティリティ
関係演算子 (C++20で非推奨)
整数比較関数
(C++20)(C++20)(C++20)    
(C++20)
swap および 型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
共通語彙型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)



 
 
ヘッダ <tuple>
template< class... Types >
std::tuple<Types&...> tie( Types&... args ) noexcept;
で定義 (C++11以上)
(C++14からconstexpr)

その引数または std::ignore のインスタンスへの左辺値参照のタプルを作成します。

パラメータ

args - タプルを構築するための0個以上の左辺値引数。

戻り値

lvalue参照を含む std::tuple オブジェクト。

実装例

template <typename... Args>
constexpr // C++14以降
std::tuple<Args&...> tie(Args&... args) noexcept
{
    return {args...};
}

注記

std::tie は std::pair をアンパックするために使用できます。これは std::tuple がペアからの 変換代入 をサポートしているためです:

bool result;
std::tie(std::ignore, result) = set.insert(value);

例

1) std::tie は構造体への辞書式比較の導入や、タプルのアンパックに使用できます;
2) std::tie は 構造化束縛 と連携できます:

#include <cassert>
#include <iostream>
#include <set>
#include <string>
#include <tuple>
struct S
{
    int n;
    std::string s;
    float d;
    friend bool operator<(const S& lhs, const S& rhs) noexcept
    {
        // lhs.nとrhs.nを比較し、
        // 次にlhs.sとrhs.sを比較し、
        // 次にlhs.dとrhs.dを比較
        // その順序で、最初の非等価な結果が返される
        // または全ての要素が等しい場合はfalseが返される
        return std::tie(lhs.n, lhs.s, lhs.d) < std::tie(rhs.n, rhs.s, rhs.d);
    }
};
int main()
{
    // 辞書式比較のデモ:
    std::set<S> set_of_s;
    S value{42, "Test", 3.14};
    std::set<S>::iterator iter;
    bool is_inserted;
    // ペアのアンパック:
    std::tie(iter, is_inserted) = set_of_s.insert(value);
    assert(is_inserted);
    // std::tieと構造化束縛:
    auto position = [](int w) { return std::tuple(1 * w, 2 * w); };
    auto [x, y] = position(1);
    assert(x == 1 && y == 2);
    std::tie(x, y) = position(2); // tieでx, yを再利用
    assert(x == 2 && y == 4);
    // 暗黙的な変換が許可される:
    std::tuple<char, short> coordinates(6, 9);
    std::tie(x, y) = coordinates;
    assert(x == 6 && y == 9);
    // 要素のスキップ:
    std::string z;
    std::tie(x, std::ignore, z) = std::tuple(1, 2.0, "Test");
    assert(x == 1 && z == "Test");
}

関連項目

構造化バインディング (C++17) 指定された名前を初期化子の部分オブジェクトまたはタプルの要素にバインドする
(C++11)
引数の型によって定義される型の tuple オブジェクトを作成する
(関数テンプレート)
転送参照 の tuple を作成する
(関数テンプレート)
(C++11)
任意の数のタプルを連結して tuple を作成する
(関数テンプレート)
(C++11)
tie を使用して tuple を展開する際に要素をスキップするためのプレースホルダ
(定数)