WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::packaged_task — aufrufbare Aufgabe mit future-Ergebnis

std::packaged_task verpackt ein aufrufbares Objekt und speichert dessen Ergebnis oder Ausnahme im gemeinsamen Zustand. std::packaged_task::get_future stellt ein std::future zum Abrufen des Ergebnisses bereit; die Aufgabe selbst startet keinen neuen Thread.

Version: 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...)> aus <future> speichert ein aufrufbares Objekt mit der angegebenen Signatur. R bezeichnet den Ergebnistyp, Args... die Argumenttypen. Das Objekt ist verschiebbar, aber nicht kopierbar. Das Erstellen einer Aufgabe startet weder die Berechnung noch einen Thread: task(args...) führt die Funktion im aufrufenden Thread aus.

std::packaged_task::get_future() gibt ein std::future<R> zurück, das mit demselben gemeinsamen Zustand verbunden ist. Es führt die Aufgabe nicht aus und kann für jeden gemeinsamen Zustand nur einmal aufgerufen werden. Ein weiterer Aufruf löst std::future_error mit std::future_errc::future_already_retrieved aus; fehlt der Zustand, etwa nach der Standardkonstruktion oder nach dem Verschieben aus dem Objekt, ergibt sich std::future_errc::no_state.

Beim Aufruf der Aufgabe werden der Rückgabewert oder die Ausnahme der Funktion gespeichert und der Zustand als bereit markiert. result.get() wartet auf die Bereitschaft und ruft den Wert ab oder löst die gespeicherte Ausnahme erneut aus; danach gibt result.valid() false zurück. Im Beispiel ist die Aufgabe vor get() abgeschlossen, daher ist kein Warten nötig. Ein Aufruf von get(), bevor die Aufgabe im selben Thread ausgeführt wird, würde die weitere Ausführung blockieren.

Ein erneuter Aufruf ohne reset() löst std::future_error mit std::future_errc::promise_already_satisfied aus. reset() erstellt für eine weitere Ausführung einen neuen Zustand. Die Aufgabe kann erneut ausgeführt werden, ohne get_future() aufzurufen; ein neues std::future<R> ist nur nötig, wenn das Ergebnis darüber abgerufen werden soll. Wird eine Aufgabe zerstört, deren Zustand noch nicht bereit ist, wird darin std::future_errc::broken_promise gespeichert, das der Empfänger über get() erhalten kann.

Beispiele

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

Ergebnis

42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen