CKTIS / C++
std::packaged_task — uma tarefa invocável com resultado future
std::packaged_task envolve um objeto invocável e guarda o respetivo resultado ou exceção no estado partilhado. std::packaged_task::get_future disponibiliza um std::future para obter esse resultado; a tarefa não inicia, por si só, uma nova thread.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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 em <future>, guarda um objeto invocável com a assinatura especificada. R indica o tipo do resultado e Args... os tipos dos argumentos. O objeto pode ser movido, mas não copiado. Criar uma tarefa não inicia o cálculo nem cria uma thread: task(args...) executa a função na thread que a chama.
std::packaged_task::get_future() devolve um std::future<R> ligado ao mesmo estado partilhado. Não executa a tarefa e só pode ser chamado uma vez para cada estado partilhado. Uma nova chamada lança std::future_error com std::future_errc::future_already_retrieved; a ausência de estado, por exemplo após a construção por omissão ou depois de mover o objeto, resulta em std::future_errc::no_state.
Ao invocar a tarefa, o valor devolvido pela função ou a respetiva exceção é guardado, e o estado fica pronto. result.get() espera até o estado estar pronto e obtém o valor ou volta a lançar a exceção guardada; depois, result.valid() devolve false. No exemplo, a tarefa termina antes de get(), pelo que não é necessário esperar. Chamar get() antes de executar a tarefa na mesma thread bloquearia a continuação da execução.
Invocar novamente a tarefa sem reset() lança std::future_error com std::future_errc::promise_already_satisfied. reset() cria um novo estado para outra execução. A tarefa pode ser invocada novamente sem chamar get_future(); só é necessário um novo std::future<R> se se pretender obter o resultado através dele. Destruir uma tarefa cujo estado ainda não esteja pronto guarda nesse estado std::future_errc::broken_promise, que o consumidor pode receber através de get().
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.