База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::packaged_task — извикваема задача с резултат във future

std::packaged_task обвива извикваем обект и съхранява резултата или изключението му в споделено състояние. std::packaged_task::get_future предоставя std::future за получаване на резултата; самата задача не стартира нова нишка.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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...)> от <future> съхранява извикваем обект с посочения тип на функцията. R задава типа на резултата, а Args... — типовете на аргументите. Обектът може да се премества, но не и да се копира. Създаването на задача не започва изчислението и не създава нишка: task(args...) изпълнява функцията в извикващата нишка.

std::packaged_task::get_future() връща std::future<R>, свързан със същото споделено състояние. Той не изпълнява задачата и може да бъде извикан само веднъж за всяко споделено състояние. Повторно извикване хвърля std::future_error с код std::future_errc::future_already_retrieved; ако няма състояние, например след конструиране по подразбиране или преместване от обекта, възниква std::future_errc::no_state.

При извикване на задачата се съхранява върнатата стойност на функцията или нейното изключение и състоянието се маркира като готово. result.get() изчаква готовността и получава стойността или повторно хвърля съхраненото изключение; след това result.valid() връща false. В примера задачата приключва преди get(), така че не е необходимо изчакване. Извикването на get() преди изпълнението на задачата в същата нишка би блокирало по-нататъшното изпълнение.

Повторно извикване на задачата без reset() хвърля std::future_error с код std::future_errc::promise_already_satisfied. reset() създава ново състояние за следващо изпълнение. Задачата може да се извика отново, без да се извиква get_future(); нов обект std::future<R> е необходим само ако резултатът трябва да се получи чрез него. При унищожаване на задача, чието състояние не е готово, в него се записва std::future_errc::broken_promise, което получателят може да получи чрез get().

Примери

#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';
}

Резултат

42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници