std::forward_as_tuple

Объявлено в заголовочном файле `<tuple>`
template< class... Types > std::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 <string>
#include <tuple>

int main()
{
    std::map<int, std::string> m;

    m.emplace(std::piecewise_construct,
              std::forward_as_tuple(6),
              std::forward_as_tuple(9, 'g'));
    std::cout << "m[6] = " << m[6] << '\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[6] = ggggggggg

См. также

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/cpp/utility/tuple/forward_as_tuple