WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::promise — einen Wert oder eine Ausnahme übergeben

std::promise<T> speichert ein einzelnes Ergebnis in einem gemeinsam genutzten Zustand, der über std::future<T> gelesen wird. Das Ergebnis kann ein Wert oder eine Ausnahme sein; das promise-Objekt selbst startet weder eine Berechnung noch einen Thread.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <future>
std::promise<T> p;
std::future<T> f = p.get_future();
p.set_value(value); // success
// Alternatively: p.set_exception(exception_ptr);

std::promise<T> aus <future> speichert das Ergebnis, das über std::future<T> abgerufen wird. std::promise::get_future() gibt ein Objekt zurück, das mit demselben gemeinsam genutzten Zustand verknüpft ist, und kann für diesen Zustand nur einmal aufgerufen werden. Ein Promise-Objekt kann verschoben, aber nicht kopiert werden; es startet selbst keinen Thread.

std::promise::set_value speichert einen Wert und markiert den Zustand als bereit. Bei std::promise<T&> speichert set_value eine Referenz; bei std::promise<void> signalisiert set_value() den Abschluss ohne Wert. Alternativ speichert std::promise::set_exception einen std::exception_ptr, der nicht null ist, zum Beispiel aus std::current_exception() innerhalb eines catch-Blocks. future.get() wartet, bis der Zustand bereit ist, und gibt den Wert zurück oder löst die gespeicherte Ausnahme erneut aus. Das Speichern des Ergebnisses synchronisiert sich mit der erfolgreichen Rückkehr aus einer Warteoperation auf diesen Zustand.

Das Ergebnis kann nur einmal erfolgreich gesetzt werden: Ein weiterer Versuch löst std::future_error mit std::future_errc::promise_already_satisfied aus. Ein erneuter Aufruf von get_future() meldet std::future_errc::future_already_retrieved; fehlt der gemeinsam genutzte Zustand, etwa nach dem Verschieben aus dem Objekt, liegt der Fehler std::future_errc::no_state vor. Wird ein Promise-Objekt zerstört, dessen Zustand noch nicht bereit ist, wird std::future_error mit std::future_errc::broken_promise gespeichert und der Zustand als bereit markiert. Dadurch endet das Warten auf diesen Zustand.

Beispiele

#include <exception>
#include <future>
#include <iostream>
#include <stdexcept>

int main() {
    std::promise<int> success;
    auto value = success.get_future();
    success.set_value(42);
    std::cout << value.get() << '\n';

    std::promise<int> failure;
    auto error = failure.get_future();
    try {
        throw std::runtime_error("calculation failed");
    } catch (...) {
        failure.set_exception(std::current_exception());
    }

    try {
        std::cout << error.get() << '\n';
    } catch (const std::runtime_error& e) {
        std::cout << e.what() << '\n';
    }
}

Ergebnis

42
calculation failed

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