CKTIS / C++
std::packaged_task — une tâche appelable avec un résultat future
std::packaged_task encapsule un objet appelable et stocke son résultat ou son exception dans un état partagé. std::packaged_task::get_future fournit un std::future pour récupérer ce résultat ; la tâche ne démarre pas elle-même un nouveau thread.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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...)>, déclaré dans <future>, stocke un objet appelable ayant la signature indiquée. R désigne le type du résultat et Args... les types des arguments. L’objet peut être déplacé, mais pas copié. Construire une tâche ne lance ni le calcul ni un thread : task(args...) exécute la fonction dans le thread appelant.
std::packaged_task::get_future() renvoie un std::future<R> lié au même état partagé. Il n’exécute pas la tâche et ne peut être appelé qu’une seule fois pour chaque état partagé. Un nouvel appel déclenche std::future_error avec std::future_errc::future_already_retrieved ; l’absence d’état, par exemple après une construction par défaut ou un déplacement depuis l’objet, entraîne std::future_errc::no_state.
L’appel de la tâche stocke la valeur de retour ou l’exception de la fonction et rend l’état prêt. result.get() attend que l’état soit prêt, récupère la valeur ou relance l’exception stockée ; ensuite, result.valid() renvoie false. Dans l’exemple, la tâche se termine avant get(), donc aucune attente n’est nécessaire. Appeler get() avant d’exécuter la tâche dans le même thread bloquerait la suite de l’exécution.
Rappeler la tâche sans reset() déclenche std::future_error avec std::future_errc::promise_already_satisfied. reset() crée un nouvel état pour une autre exécution. La tâche peut être appelée de nouveau sans appeler get_future() ; un nouveau std::future<R> n’est nécessaire que pour récupérer le résultat par son intermédiaire. La destruction d’une tâche dont l’état n’est pas prêt y stocke std::future_errc::broken_promise, que le consommateur peut recevoir avec get().
Exemples
#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';
}
Résultat
42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.