WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::future: einmaliges asynchrones Ergebnis

std::future ist ein verschiebbarer, nicht kopierbarer Handle auf einen gemeinsamen Zustand mit Wert oder Ausnahme.

Version: C++23

Syntax

template<class R> class std::future {
public:
    future() noexcept;
    future(future&&) noexcept;
    future(const future&) = delete;

    R get();
    bool valid() const noexcept;
    void wait() const;
    template<class Rep, class Period>
    std::future_status wait_for(const std::chrono::duration<Rep, Period>& timeout) const;

    std::shared_future<R> share() noexcept;
};

std::future<R> aus <future> ist die exklusive Empfängerseite eines von std::promise, std::packaged_task oder std::async erzeugten gemeinsamen Zustands. wait() blockiert bis zur Bereitschaft; wait_for und wait_until melden ready, timeout oder deferred. std::future::get wartet und entnimmt für future<R> einen verschobenen Wert, für future<R&> eine Referenz und für future<void> nichts. std::future::share überträgt den Zustand auf ein shared_future, und std::future::valid prüft, ob der Handle noch einen Zustand besitzt.

Das Beispiel erhält ein Future von std::promise<int>, startet einen Thread, der 42 setzt, und ruft result.get() auf. Das Setzen macht den Zustand bereit und synchronisiert den Empfänger. get() liefert 42 und gibt danach den Zustand frei, deshalb ist result.valid() falsch. Nach join() lautet die Ausgabe 42 0. Das Promise wird per Referenz erfasst, lebt aber bis zum Threadende.

std::future ist einmalig: Nach get(), share() oder Verschieben besitzt das Quellobjekt keinen Zustand. Die meisten Aufrufe bei valid() == false haben undefiniertes Verhalten; die empfohlene Erkennung durch std::future_error(no_state) ist nicht garantiert. get() wirft eine gespeicherte Ausnahme erneut; die Zerstörung eines std::promise ohne Ergebnis speichert broken_promise. Für mehrere Empfänger dient std::shared_future. Memberaufrufe desselben Future synchronisieren sich nicht untereinander und dürfen nicht gleichzeitig auf einem Objekt erfolgen.

Beispiele

#include <future>
#include <iostream>
#include <thread>

int main() {
    std::promise<int> promise;
    std::future<int> result = promise.get_future();
    std::thread producer([&promise] { promise.set_value(42); });

    const int value = result.get();
    producer.join();
    std::cout << value << ' ' << result.valid() << '\n';
}

Ergebnis

42 0

std::future → 42 0

Quellen