CKTIS / C++
std::future_status — resultaat van wachten met een tijdslimiet
std::future_status is een scoped enumeratie uit <future>, die wordt teruggegeven door wait_for() en wait_until(). De waarden onderscheiden een gereed resultaat, een verstreken tijdslimiet en uitgestelde uitvoering. De status zelf haalt de waarde niet op en zegt niet of de berekening zonder uitzondering is voltooid.
Versie: 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 is een enum class uit <future>. De members wait_for() en wait_until() van std::future<T> en std::shared_future<T> geven dit type terug. De eerste neemt een tijdsduur, de tweede een tijdstip. Ze controleren of de gedeelde toestand gereed is, maar halen het resultaat niet op.
std::future_status::ready betekent dat de gedeelde toestand een waarde of een klaarstaande uitzondering bevat. Dit garandeert geen succesvolle berekening: get() kan de opgeslagen uitzondering opnieuw gooien. std::future_status::timeout betekent dat het wachten eindigde doordat de tijdslimiet verstreek; het annuleert de taak niet en bewijst niet dat die nog loopt wanneer je de status bekijkt.
std::future_status::deferred betekent dat de toestand een uitgestelde functie bevat, bijvoorbeeld een functie die is gemaakt met std::async(std::launch::deferred, ...). Wachten met een tijdslimiet start die functie niet en geeft deze status terug zonder op het verstrijken van de tijdslimiet te wachten. Het eerste wachten zonder tijdslimiet, via wait() of get(), voert haar uit in de aanroepende thread. Een lus die alleen wait_for() peilt, start zo’n taak niet.
Roep wachtmembers alleen aan voor een object met een gedeelde toestand: valid() betekent niet ready. Bij std::future<T> verbruikt een aanroep van get() het resultaat en wordt valid() == false; daarna wachten op dat object heeft ongedefinieerd gedrag. Het voorbeeld controleert alle drie statussen deterministisch met wait_for(0ms), een promise en een expliciet uitgestelde taak, zonder de thread te laten slapen. De aangehaalde pagina’s tonen een doorlopend werkdocument, geen bevroren C++23-tekst.
Voorbeelden
#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';
}
Resultaat
timeout: true ready: true deferred: true values: 42 7
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.