CKTIS / C++
std::future_status — Ergebnis eines Wartens mit Zeitlimit
std::future_status ist eine Enumeration mit Gültigkeitsbereich aus <future>, die von wait_for() und wait_until() zurückgegeben wird. Sie unterscheidet ein bereites Ergebnis, einen abgelaufenen Timeout und eine aufgeschobene Ausführung. Der Status selbst ruft weder den Wert ab noch sagt er aus, ob die Berechnung ohne Ausnahme abgeschlossen wurde.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <future>
// Declared in namespace std:
enum class future_status { ready, timeout, deferred };
// f.wait_for(duration) and f.wait_until(time_point) return std::future_status.std::future_status ist ein enum class aus <future>. Die Member wait_for() und wait_until() von std::future<T> und std::shared_future<T> geben diesen Typ zurück. Ersteres nimmt eine Dauer entgegen, Letzteres einen Zeitpunkt. Sie prüfen, ob der gemeinsame Zustand bereit ist, statt das Ergebnis abzurufen.
std::future_status::ready bedeutet, dass der gemeinsame Zustand einen Wert oder eine zum Abruf bereite Ausnahme enthält. Es garantiert keine erfolgreiche Berechnung: get() kann die gespeicherte Ausnahme erneut auslösen. std::future_status::timeout bedeutet, dass das Warten wegen des abgelaufenen Zeitlimits zurückkehrte; es bricht die Aufgabe nicht ab und beweist nicht, dass diese beim Prüfen des Status noch läuft.
std::future_status::deferred bedeutet, dass der Zustand eine aufgeschobene Funktion enthält, zum Beispiel eine, die mit std::async(std::launch::deferred, ...) erstellt wurde. Ein Warten mit Zeitlimit startet sie nicht und gibt diesen Status zurück, ohne das Zeitlimit abzuwarten. Das erste Warten ohne Zeitlimit über wait() oder get() führt sie im aufrufenden Thread aus. Eine Schleife, die nur wait_for() abfragt, startet eine solche Aufgabe nicht.
Rufe Wartemethoden nur für ein Objekt mit gemeinsamem Zustand auf: valid() bedeutet nicht ready. Bei std::future<T> verbraucht der Aufruf von get() das Ergebnis und setzt valid() == false; weiteres Warten auf diesem Objekt führt zu undefiniertem Verhalten. Das Beispiel prüft alle drei Status deterministisch mit wait_for(0ms), einem Promise und einer ausdrücklich aufgeschobenen Aufgabe, ohne den Thread schlafen zu legen. Die zitierten Seiten zeigen einen fortlaufend gepflegten Arbeitsentwurf, keinen eingefrorenen C++23-Text.
Beispiele
#include <chrono>
#include <future>
#include <iostream>
int main() {
using namespace std::chrono_literals;
std::cout << std::boolalpha;
std::promise<int> producer;
auto result = producer.get_future();
std::cout << "timeout: "
<< (result.wait_for(0ms) == std::future_status::timeout) << '\n';
producer.set_value(42);
std::cout << "ready: "
<< (result.wait_for(0ms) == std::future_status::ready) << '\n';
auto lazy = std::async(std::launch::deferred, [] { return 7; });
std::cout << "deferred: "
<< (lazy.wait_for(0ms) == std::future_status::deferred) << '\n';
std::cout << "values: " << result.get() << ' ' << lazy.get() << '\n';
}
Ergebnis
timeout: true ready: true deferred: true values: 42 7
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.