std::forward_as_tuple

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

Создаёт кортеж ссылок на аргументы в args, пригодный для передачи в качестве аргумента функции. Кортеж содержит ссылки на rvalue, если в качестве аргументов используются rvalue, и ссылки на lvalue в противном случае.

Параметры

args

ноль или более аргументов для создания кортежа

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

Объект типа std::tuple, созданный как если бы с помощью std::tuple<Types&&...>(std::forward<Types>(args)...)

Примечания

Если аргументы являются временными объектами, forward_as_tuple не продлевает их срок жизни; они должны быть использованы до конца выражения.

Пример

#include <iostream>
#include <map>
#include <tuple>
#include <string>
 
int main()
{
    std::map<int, std::string> m;
 
    m.emplace(std::piecewise_construct,
              std::forward_as_tuple(10),
              std::forward_as_tuple(20, 'a'));
    std::cout << "m[10] = " << m[10] << '\n';
 
    // The following is an error: it produces a
    // std::tuple<int&&, char&&> holding two dangling references.
    //
    // auto t = std::forward_as_tuple(20, 'a');
    // m.emplace(std::piecewise_construct, std::forward_as_tuple(10), t);
}

Вывод:

m[10] = aaaaaaaaaaaaaaaaaaaa

См. также

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

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