CKTIS / C++
std::packaged_task — zadanie z wynikiem dostępnym przez future
std::packaged_task opakowuje obiekt wywoływalny i zapisuje jego wynik lub wyjątek we współdzielonym stanie. std::packaged_task::get_future udostępnia std::future do odebrania wyniku; samo zadanie nie uruchamia nowego wątku.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 nagłówka <future> przechowuje obiekt wywoływalny o zadanej sygnaturze. R określa typ wyniku, a Args... — typy argumentów. Obiekt można przenosić, ale nie kopiować. Samo utworzenie zadania nie rozpoczyna obliczeń ani nie tworzy wątku: task(args...) wykonuje funkcję w wątku wywołującym.
std::packaged_task::get_future() zwraca std::future<R> powiązany z tym samym stanem. Nie wykonuje zadania i można go wywołać tylko raz dla danego stanu. Ponowne wywołanie zgłasza std::future_error z kodem std::future_errc::future_already_retrieved; brak stanu, na przykład po konstrukcji domyślnej lub przeniesieniu z obiektu, oznacza std::future_errc::no_state.
Wywołanie zadania zapisuje wartość zwrotną albo wyjątek funkcji i oznacza stan jako gotowy. result.get() czeka na gotowość, odbiera wartość albo ponownie zgłasza zapisany wyjątek; następnie result.valid() zwraca false. W przykładzie zadanie kończy się przed get(), więc oczekiwanie nie jest potrzebne. Wywołanie get() przed uruchomieniem zadania w tym samym wątku zablokowałoby dalsze wykonanie.
Ponowne wykonanie zadania bez reset() zgłasza std::future_error z kodem std::future_errc::promise_already_satisfied. reset() tworzy nowy stan dla kolejnego wykonania. Zadanie można wywołać ponownie bez wywoływania get_future(); nowy obiekt std::future<R> jest potrzebny tylko wtedy, gdy wynik ma zostać odebrany za jego pośrednictwem. Zniszczenie zadania z niegotowym stanem zapisuje w nim błąd std::future_errc::broken_promise, który odbiorca może otrzymać przez get().
Przykłady
#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';
}
Wynik
42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.