close
Пространства имён
Варианты
Действия

std::tie

Материал из cppreference.com
 
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
Трёхстороннее сравнение (C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
Общие утилиты
Дата и время
Функциональные объекты
Библиотека форматирования (C++20)
(C++11)
Операторы отношения (устарело в C++20)
Целочисленные функции сравнения
(C++20)(C++20)(C++20)    
(C++20)
Операции обмена и типа
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
 
 
<tbody> </tbody> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>
Определено в заголовочном файле <tuple>
template< class... Types > std::tuple<Types&...> tie( Types&... args ) noexcept;
(начиная с C++11)
(до C++14)
template< class... Types > constexpr std::tuple<Types&...> tie( Types&... args ) noexcept;
(начиная с C++14)

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

Параметры

args ноль или более аргументов lvalue для построения кортежа.

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

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

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

template <typename... Args>
constexpr // начиная с C++14
std::tuple<Args&...> tie(Args&... args) noexcept {
    return {args...};
}

Примечание

std::tie можно использовать для распаковки std::pair, потому что std::tuple имеет преобразующее присваивание из pair:

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

Пример

1) std::tie можно использовать для введения лексикографического сравнения в структуру или для распаковки кортежа;
2) std::tie может работать с структурными привязками:

#include <iostream>
#include <string>
#include <set>
#include <tuple>

struct S {
    int n;
    std::string s;
    float d;
    bool operator<(const S& rhs) const
    {
        // сравнивает n с rhs.n,
        // затем s с rhs.s,
        // затем d с rhs.d
        return std::tie(n, s, d) < std::tie(rhs.n, rhs.s, rhs.d);
    }
};

int main()
{
    // Демонстрация лексикографического сравнения: //

    std::set<S> set_of_s; // S является LessThanComparable

    S value{42, "Тест", 3.14};
    std::set<S>::iterator iter;
    bool inserted;

    // распаковывает возвращаемое значение insert в iter и inserted
    std::tie(iter, inserted) = set_of_s.insert(value);
    assert(inserted);

    // std::tie может работать вместе со структурными привязками C++17: //

    auto position = [](int w) { return std::tuple<int, int>{ 1 * w, 2 * w }; };

    auto [x, y] = position(1);
    assert(x == 1 and y == 2);
    // ...
    std::tie(x, y) = position(2); // reuse x, y with tie
    assert(x == 2 and y == 4);

    // подтипы, возвращаемые вызываемым объектом, могут отличаться
    auto coordinates = [] { return std::tuple<char, short>(6, 9); };
    // ...
    std::tie(x, y) = coordinates(); // неявные преобразования
    assert(x == 6 and y == 9);
}

Смотрите также

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