Namespaces
Variants

std::packaged_task<R(Args...)>:: packaged_task

From cppreference.net
C++
Concurrency support library
Threads
(C++11)
(C++20)
(C++17) (C++17)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20) (C++20)
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
(C++26)
(C++26)
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
(C++11)
Memory ordering
(C++11)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
Free functions for atomic operations
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11) (C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++26) (C++26)
(C++26) (C++26)
(C++11)
(C++20) (C++20)
(C++20)
(C++20)
Free functions for atomic flags
(C++11) (C++11)
(C++11) (C++11)
(C++20) (C++20)
(C++20) (C++20)
(C++20)
(C++20)
std::packaged_task
packaged_task ( ) noexcept ;
(1) (desde C++11)
template < class F >
explicit packaged_task ( F && f ) ;
(2) (desde C++11)
template < class F, class Allocator >
explicit packaged_task ( std:: allocator_arg_t , const Allocator & a, F && f ) ;
(3) (desde C++11)
(hasta C++17)
packaged_task ( const packaged_task & ) = delete ;
(4) (desde C++11)
packaged_task ( packaged_task && rhs ) noexcept ;
(5) (desde C++11)

Construye un nuevo objeto std::packaged_task .

1) Construye un objeto std::packaged_task sin tarea y sin estado compartido.
2,3) Construye un objeto std::packaged_task con una tarea almacenada de tipo std:: decay < F > :: type y un estado compartido. La tarea almacenada se inicializa con std:: forward < F > ( f ) .

Estas sobrecargas participan en la resolución de sobrecarga solo si std:: decay < F > :: type no es del mismo tipo que std:: packaged_task < R ( Args... ) > .

Sean t1 , t2 , ..., tN valores de los tipos correspondientes en Args , si INVOKE<R> ( f, t1, t2, ..., tN ) no es una expresión válida, el programa está mal formado.

(hasta C++20)

Esta sobrecarga participa en la resolución de sobrecarga solo si std:: remove_cvref_t < F > no es del mismo tipo que std:: packaged_task < R ( Args... ) > .

Si std:: is_invocable_r_v < R, std:: decay_t < F > & , Args... > es false , el programa está mal formado.

(desde C++20)
3) El asignador a se utiliza para asignar la memoria necesaria para almacenar la tarea.
4) El constructor de copia está eliminado, std::packaged_task es solo de movimiento.
5) Construye un std::packaged_task con el estado compartido y la tarea previamente propiedad de rhs , dejando a rhs sin estado compartido y con una tarea en estado movido.

Contenidos

Parámetros

f - el objetivo invocable a ejecutar
a - el asignador de memoria a utilizar al almacenar la tarea
rhs - el std::packaged_task desde el cual mover

Excepciones

2) Cualquier excepción lanzada por el constructor de copia/movimiento de f y posiblemente std::bad_alloc si la asignación de memoria falla.
3) Cualquier excepción lanzada por el constructor de copia/movimiento de f y por la función allocate del asignador si falla la asignación de memoria.

Ejemplo

Ejecutar este código 
#include <future>
#include <iostream>
#include <thread>
int fib(int n)
{
    if (n < 3)
        return 1;
    else
        return fib(n - 1) + fib(n - 2);
}
int main()
{
    std::packaged_task<int(int)> fib_task(&fib); 
    std::cout << "Iniciando tarea\n";
    auto result = fib_task.get_future();
    std::thread t(std::move(fib_task), 42);
    std::cout << "Esperando a que la tarea finalice..." << std::endl;
    std::cout << result.get() << '\n';
    std::cout << "Tarea completada\n";
    t.join();
}

Salida: 

Iniciando tarea
Esperando a que la tarea finalice...
267914296
Tarea completada

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 2067 C++11 el tipo de parámetro del constructor de copia era packaged_task& se añadió const
LWG 2097 C++11 para las sobrecargas (2,3) , F podría ser std::packaged_task<R(Args...)> F está restringido
LWG 4154 C++11 las sobrecargas (2,3) no consideraban el decaimiento considerar el decaimiento