CKTIS / C++
std::packaged_task — volateľná úloha s výsledkom vo future
std::packaged_task zabalí volateľný objekt a uloží jeho výsledok alebo výnimku do zdieľaného stavu. std::packaged_task::get_future poskytne std::future na získanie výsledku; samotná úloha nový thread nespúšťa.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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...)> z hlavičky <future> uchováva volateľný objekt so zadanou signatúrou. R určuje typ výsledku a Args... typy argumentov. Objekt možno presúvať, ale nemožno ho kopírovať. Vytvorenie úlohy nespustí výpočet ani nevytvorí thread: task(args...) vykoná funkciu vo volajúcom threade.
std::packaged_task::get_future() vráti std::future<R> prepojený s tým istým zdieľaným stavom. Úlohu nespúšťa a pre každý zdieľaný stav ho možno zavolať iba raz. Ďalšie volanie vyvolá std::future_error s kódom std::future_errc::future_already_retrieved; ak stav chýba, napríklad po predvolenej konštrukcii alebo po presunutí objektu, nastane std::future_errc::no_state.
Pri zavolaní úlohy sa uloží návratová hodnota funkcie alebo jej výnimka a stav sa označí ako pripravený. result.get() čaká na pripravenosť a získa hodnotu alebo znova vyvolá uloženú výnimku; potom result.valid() vráti false. V príklade sa úloha skončí pred volaním get(), takže čakanie nie je potrebné. Volanie get() pred spustením úlohy v tom istom threade by zablokovalo ďalšie vykonávanie.
Opätovné zavolanie úlohy bez reset() vyvolá std::future_error s kódom std::future_errc::promise_already_satisfied. reset() vytvorí nový stav na ďalšie spustenie. Úlohu možno znova zavolať aj bez volania get_future(); nový objekt std::future<R> je potrebný len vtedy, ak sa má výsledok získať prostredníctvom neho. Pri zničení úlohy, ktorej stav nie je pripravený, sa doň uloží std::future_errc::broken_promise, ktoré príjemca môže získať cez get().
Príklady
#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';
}
Výsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.