CKTIS / C++
std::packaged_task — volatelná úloha s výsledkem ve future
std::packaged_task zabalí volatelný objekt a uloží jeho výsledek nebo výjimku do sdíleného stavu. std::packaged_task::get_future poskytne std::future pro získání výsledku; samotná úloha nový thread nespouští.
Verze: 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...)> z hlavičky <future> uchovává volatelný objekt se zadanou signaturou. R určuje typ výsledku a Args... typy argumentů. Objekt lze přesouvat, ale nelze jej kopírovat. Vytvoření úlohy nespustí výpočet ani nevytvoří thread: task(args...) provede funkci ve volajícím threadu.
std::packaged_task::get_future() vrátí std::future<R> propojený se stejným sdíleným stavem. Úlohu nespouští a pro každý sdílený stav jej lze zavolat pouze jednou. Další volání vyvolá std::future_error s kódem std::future_errc::future_already_retrieved; pokud stav chybí, například po výchozí konstrukci nebo po přesunutí objektu, nastane std::future_errc::no_state.
Při zavolání úlohy se uloží návratová hodnota funkce nebo její výjimka a stav se označí jako připravený. result.get() čeká na připravenost a získá hodnotu nebo znovu vyvolá uloženou výjimku; poté result.valid() vrátí false. V příkladu úloha skončí před voláním get(), takže čekání není potřeba. Volání get() před spuštěním úlohy ve stejném threadu by zablokovalo další provádění.
Opětovné zavolání úlohy bez reset() vyvolá std::future_error s kódem std::future_errc::promise_already_satisfied. reset() vytvoří nový stav pro další spuštění. Úlohu lze znovu zavolat i bez volání get_future(); nový objekt std::future<R> je potřeba jen tehdy, má-li se jeho prostřednictvím získat výsledek. Při zničení úlohy, jejíž stav není připravený, se do něj uloží std::future_errc::broken_promise, které příjemce může získat voláním get().
Pří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ýsledek
42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.