CKTIS / C++
std::packaged_task — klicljiva naloga z rezultatom future
std::packaged_task ovije klicljiv objekt in shrani njegov rezultat ali izjemo v skupno stanje. std::packaged_task::get_future zagotovi std::future za pridobitev rezultata; naloga sama ne zažene nove niti.
Različica: 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 <future> hrani klicljiv objekt z določeno signaturo. R določa tip rezultata, Args... pa tipe argumentov. Objekt je mogoče premakniti, ne pa kopirati. Ustvarjanje naloge ne začne izračuna in ne ustvari niti: task(args...) izvede funkcijo v klicni niti.
std::packaged_task::get_future() vrne std::future<R>, povezan z istim skupnim stanjem. Naloge ne izvede in za vsako skupno stanje ga je mogoče poklicati le enkrat. Ponovni klic sproži std::future_error s kodo std::future_errc::future_already_retrieved; če stanje ne obstaja, na primer po privzeti konstrukciji ali premiku objekta, nastopi std::future_errc::no_state.
Ob klicu naloge se shrani vrnjena vrednost funkcije ali njena izjema, stanje pa postane pripravljeno. result.get() počaka, da je stanje pripravljeno, in pridobi vrednost ali znova sproži shranjeno izjemo; nato result.valid() vrne false. V primeru se naloga konča pred klicem get(), zato čakanje ni potrebno. Klic get() pred izvedbo naloge v isti niti bi blokiral nadaljnje izvajanje.
Ponovni klic naloge brez reset() sproži std::future_error s kodo std::future_errc::promise_already_satisfied. reset() ustvari novo stanje za naslednjo izvedbo. Nalogo je mogoče znova poklicati brez klica get_future(); nov objekt std::future<R> je potreben le, če želimo prek njega pridobiti rezultat. Če uničimo nalogo, katere stanje še ni pripravljeno, se vanj shrani std::future_errc::broken_promise, ki ga lahko prejemnik prejme prek get().
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.