CKTIS / C++
std::packaged_task — pozivni zadatak s rezultatom future
std::packaged_task omata pozivni objekt i pohranjuje njegov rezultat ili iznimku u zajedničko stanje. std::packaged_task::get_future daje std::future za dohvaćanje rezultata; sam zadatak ne pokreće novu dretvu.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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...)> iz zaglavlja <future> pohranjuje pozivni objekt zadane signaturne oznake. R određuje tip rezultata, a Args... tipove argumenata. Objekt se može premještati, ali ne i kopirati. Stvaranje zadatka ne pokreće izračun niti stvara dretvu: task(args...) izvršava funkciju u dretvi koja ga poziva.
std::packaged_task::get_future() vraća std::future<R> povezan s istim zajedničkim stanjem. Ne izvršava zadatak i može se pozvati samo jednom za svako zajedničko stanje. Ponovni poziv izaziva std::future_error s kodom std::future_errc::future_already_retrieved; ako stanje ne postoji, primjerice nakon zadane konstrukcije ili premještanja objekta, nastaje std::future_errc::no_state.
Pozivom zadatka pohranjuje se povratna vrijednost funkcije ili njezina iznimka, a stanje postaje spremno. result.get() čeka da stanje bude spremno te dohvaća vrijednost ili ponovno baca pohranjenu iznimku; nakon toga result.valid() vraća false. U primjeru zadatak završava prije poziva get(), pa čekanje nije potrebno. Poziv get() prije pokretanja zadatka u istoj dretvi blokirao bi daljnje izvođenje.
Ponovni poziv zadatka bez reset() izaziva std::future_error s kodom std::future_errc::promise_already_satisfied. reset() stvara novo stanje za sljedeće izvršavanje. Zadatak se može ponovno pozvati bez poziva get_future(); novi objekt std::future<R> potreban je samo ako se rezultat želi dohvatiti preko njega. Uništavanjem zadatka čije stanje nije spremno u to se stanje pohranjuje std::future_errc::broken_promise, koji primatelj može dobiti pozivom get().
Primjeri
#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';
}
Rezultat
42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.