std::tie

Определено в заголовке `<tuple>`
template< class... Types > std::tuple<Types&...> tie( Types&... args ) noexcept;		(начиная с C++11) (constexpr начиная с C++14)

Создаёт кортеж из ссылок на lvalue-значения аргументов или экземпляров std::ignore.

Параметры

args

ноль или более аргументов-lvalue, из которых создаётся кортеж.

Возвращаемое значение

Объект std::tuple, содержащий ссылки на lvalue-значения.

Возможная реализация

template <typename... Args>
constexpr // since 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
    {
        // compares lhs.n to rhs.n,
        // then lhs.s to rhs.s,
        // then lhs.d to rhs.d
        // in that order, first non-equal result is returned
        // or false if all elements are equal
        return std::tie(lhs.n, lhs.s, lhs.d) < std::tie(rhs.n, rhs.s, rhs.d);
    }
};

int main()
{
    // Lexicographical comparison demo:
    std::set<S> set_of_s;

    S value{42, "Test", 3.14};
    std::set<S>::iterator iter;
    bool is_inserted;

    // Unpack a pair:
    std::tie(iter, is_inserted) = set_of_s.insert(value);
    assert(is_inserted);


    // std::tie and structured bindings:
    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); // reuse x, y with tie
    assert(x == 2 && y == 4);


    // Implicit conversions are permitted:
    std::tuple<char, short> coordinates(6, 9);
    std::tie(x, y) = coordinates;
    assert(x == 6 && y == 9);

    // Skip an element:
    std::string z;
    std::tie(x, std::ignore, z) = std::tuple(1, 2.0, "Test");
    assert(x == 1 && z == "Test");
}

См. также

Структурная привязка (C++17)	связывает указанные имена с подобъектами или элементами кортежа инициализатора
make_tuple (C++11)	создаёт объект `tuple` типа, определяемого типами аргументов (шаблон функции)
forward_as_tuple (C++11)	создаёт `tuple` из пересылающих ссылок (шаблон функции)
tuple_cat (C++11)	создаёт `tuple` путём объединения любого количества кортежей (шаблон функции)
ignore (C++11)	заполнитель для пропуска элемента при распаковке `tuple` с помощью `tie` (константа)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/tuple/tie