std::packaged_task

在头文件 `<future>` 中定义
template< class > class packaged_task;	(1)	(C++11 起) (未定义)
template< class R, class ...ArgTypes > class packaged_task<R(ArgTypes...)>;	(2)	(C++11 起)

类模板 std::packaged_task 封装了任何可调用 (Callable) 目标（函数、lambda 表达式、bind 表达式或其他函数对象），使其可以异步调用。其返回值或抛出的异常存储在一个共享状态中，该状态可以通过 std::future 对象访问。

与 std::function 类似，std::packaged_task 是一个多态的、感知分配器的容器：存储的可调用目标可以分配在堆上，或者使用提供的分配器分配。

(C++17 前)

(构造函数)	构造任务对象 (public member function) [编辑]
(析构函数)	销毁任务对象 (public member function) [编辑]
operator=	移动任务对象 (public member function) [编辑]
valid	检查任务对象是否有有效函数 (public member function) [编辑]
swap	交换两个任务对象 (public member function) [编辑]
Getting the result
get_future	返回与承诺结果关联的 std::future (public member function) [编辑]
执行
operator()	执行函数 (public member function) [编辑]
make_ready_at_thread_exit	执行函数，确保仅在当前线程退出后结果才就绪 (public member function) [编辑]
reset	重置状态，放弃之前执行的任何存储结果 (public member function) [编辑]

[编辑] 非成员函数

std::swap(std::packaged_task)

(C++11)

特化 std::swap 算法
(函数模板) [编辑]

[编辑] 辅助类

std::uses_allocator<std::packaged_task>

(C++11) (直到 C++17)

特化 std::uses_allocator 类型特性
(类模板特化) [编辑]

[编辑] 推导指南 (C++17 起)

[编辑] 示例

运行此代码

#include <cmath>
#include <functional>
#include <future>
#include <iostream>
#include <thread>
 
// unique function to avoid disambiguating the std::pow overload set
int f(int x, int y) { return std::pow(x, y); }
 
void task_lambda()
{
    std::packaged_task<int(int, int)> task([](int a, int b)
    {
        return std::pow(a, b); 
    });
    std::future<int> result = task.get_future();
 
    task(2, 9);
 
    std::cout << "task_lambda:\t" << result.get() << '\n';
}
 
void task_bind()
{
    std::packaged_task<int()> task(std::bind(f, 2, 11));
    std::future<int> result = task.get_future();
 
    task();
 
    std::cout << "task_bind:\t" << result.get() << '\n';
}
 
void task_thread()
{
    std::packaged_task<int(int, int)> task(f);
    std::future<int> result = task.get_future();
 
    std::thread task_td(std::move(task), 2, 10);
    task_td.join();
 
    std::cout << "task_thread:\t" << result.get() << '\n';
}
 
int main()
{
    task_lambda();
    task_bind();
    task_thread();
}

输出

task_lambda: 512
task_bind:   2048
task_thread: 1024

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	发布时的行为	正确的行为
LWG 3117	C++17	缺少 `packaged_task` 的推导指南	已添加

[编辑] 参阅

future

(C++11)

等待一个异步设置的值
(类模板) [编辑]

编译器支持
自由（freestanding）与宿主（hosted）
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

成员函数
packaged_task::packaged_task
packaged_task::~packaged_task
packaged_task::operator=
packaged_task::valid
packaged_task::swap
Getting the result
packaged_task::get_future
执行
packaged_task::operator()
packaged_task::make_ready_at_thread_exit
packaged_task::reset
非成员函数
swap(std::packaged_task)
辅助类
uses_allocator<std::packaged_task> (C++17 前)
推导指南(C++17)

cppreference.cn

命名空间

变体

视图

操作