CKTIS / C++
std::packaged_task — una tarea invocable con resultado future
std::packaged_task envuelve un objeto invocable y almacena su resultado o excepción en un estado compartido. std::packaged_task::get_future proporciona un std::future para obtener ese resultado; la tarea no inicia por sí misma un hilo nuevo.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <future>
std::packaged_task<R(Args...)> task(callable);
std::future<R> result = task.get_future();
task(args...);
result.get();std::packaged_task<R(Args...)>, declarado en <future>, almacena un objeto invocable con la firma indicada. R especifica el tipo del resultado y Args..., los tipos de los argumentos. El objeto se puede mover, pero no copiar. Construir una tarea no inicia ni el cálculo ni un hilo: task(args...) ejecuta la función en el hilo que la llama.
std::packaged_task::get_future() devuelve un std::future<R> conectado al mismo estado compartido. No ejecuta la tarea y solo se puede llamar una vez por cada estado compartido. Si se vuelve a llamar, lanza std::future_error con std::future_errc::future_already_retrieved; si no hay estado, por ejemplo tras la construcción predeterminada o después de mover el objeto, se produce std::future_errc::no_state.
Al invocar la tarea, se almacena el valor devuelto por la función o su excepción, y el estado pasa a estar listo. result.get() espera a que esté listo y recupera el valor o vuelve a lanzar la excepción almacenada; después, result.valid() devuelve false. En el ejemplo, la tarea termina antes de get(), así que no hace falta esperar. Llamar a get() antes de ejecutar la tarea en el mismo hilo bloquearía la continuación de la ejecución.
Volver a invocar la tarea sin reset() lanza std::future_error con std::future_errc::promise_already_satisfied. reset() crea un estado nuevo para otra ejecución. Se puede volver a invocar la tarea sin llamar a get_future(); solo hace falta un nuevo std::future<R> si se quiere obtener el resultado a través de él. Si se destruye una tarea cuyo estado aún no está listo, se almacena en él std::future_errc::broken_promise, que el consumidor puede recibir mediante get().
Ejemplos
#include <future>
#include <iostream>
int main() {
std::packaged_task<int(int, int)> task(
[](int a, int b) { return a + b; });
std::future<int> result = task.get_future();
task(20, 22);
std::cout << result.get() << '\n';
}
Resultado
42
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.