std::forward_as_tuple

来自cppreference.com
< cpp‎ | utility‎ | tuple
 
C++
 
工具库
类型支持（基本类型、 RTTI 、类型特性）
动态内存管理
错误处理
程序工具
变参数函数
库特性测试宏
日期和时间
函数对象
格式化库 (C++20)
(C++11)
(C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
比较 (C++20)
共用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

swap 、 forward 与 move
(C++14)
(C++11)
(C++11)
(C++11)
初等字符串转换
(C++17)
(C++17)
(C++17)
类型运算
(C++11)
(C++17)
(C++17)
 
std::tuple
 
定义于头文件 <tuple>
template< class... Types >
tuple<Types&&...> forward_as_tuple( Types&&... args ) noexcept;
 (C++11 起)
(C++14 前)
template< class... Types >
constexpr tuple<Types&&...> forward_as_tuple( Types&&... args ) noexcept;
 (C++14 起)

构造到 args 中参数的，适于转发成函数参数的引用的 tuple 。该 tuple 在以右值为参数时拥有右值引用数据成员，否则拥有左值引用数据成员。

参数

args - 构造 tuple 所用的零或更多参数

返回值

如同以 std::tuple<Types&&...>(std::forward<Types>(args)...) 创建的 std::tuple 对象。

注意

若参数是临时量，则 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';
 
    // 下面是错误：它产生保有二个悬垂引用的 std::tuple<int&&, char&&>
    //
    // auto t = std::forward_as_tuple(20, 'a');
    // m.emplace(std::piecewise_construct, std::forward_as_tuple(10), t);
}

输出： 

m[10] = aaaaaaaaaaaaaaaaaaaa

参阅

 创建一个 tuple 对象，其类型根据各实参类型定义
(函数模板)
创建左值引用的 tuple，或将 tuple 解包为独立对象
(函数模板)
通过连接任意数量的元组来创建一个tuple
(函数模板)
(C++17)
 以一个实参的元组来调用函数
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/tuple/forward_as_tuple&oldid=45882”