Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje