std::forward_as_tuple

来自cppreference.com
< cpp‎ | utility‎ | tuple
 
 
 
 
在标头 <tuple> 定义
template< class... Types >
std::tuple<Types&&...> forward_as_tuple( Types&&... args ) noexcept;
(C++11 起)
(C++14 起为 constexpr)

构造到 args 中的各实参的引用的元组,适于作为实参转发给函数。该元组在以右值为实参时拥有右值引用数据成员,否则拥有左值引用数据成员。

目录

[编辑] 参数

args - 为之构造元组的零或更多实参

[编辑] 返回值

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

[编辑] 注解

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

输出:

m[6] = ggggggggg

[编辑] 参阅

创建一个 tuple 对象,其类型根据各实参类型定义
(函数模板) [编辑]
(C++11)
创建左值引用的 tuple,或将元组解包为独立对象
(函数模板) [编辑]
(C++11)
通过连接任意数量的元组来创建一个tuple
(函数模板) [编辑]
(C++17)
以一个实参的元组来调用函数
(函数模板) [编辑]