# std::forward_as_tuple

< cpp‎ | utility‎ | 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

### 参阅

make_tuple | 创建一个 `tuple` 对象，其类型根据各实参类型定义 (函数模板)
tie | 创建左值引用的 `tuple`，或将 tuple 解包为独立对象 (函数模板)
tuple_cat | 通过连接任意数量的元组来创建一个`tuple` (函数模板)
apply (C++17) | 以一个实参的元组来调用函数 (函数模板)