std::forward_as_tuple

来自cppreference.com
< cpp‎ | utility‎ | tuple
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
 
std::tuple
成员函数
非成员函数
forward_as_tuple
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
推导指引(C++17)
辅助概念
(C++23)
辅助类
 
在标头 <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 对象,其类型根据各实参类型定义
(函数模板)
(C++11)
创建左值引用的 tuple,或将 tuple 解包为独立对象
(函数模板)
(C++11)
通过连接任意数量的元组来创建一个tuple
(函数模板)
(C++17)
以一个实参的元组来调用函数
(函数模板)