CKTIS / C++
std::future_status — výsledok čakania s časovým limitom
std::future_status je výčtový typ s určeným rozsahom z <future>, ktorý vracajú wait_for() a wait_until(). Rozlišuje pripravený výsledok, uplynutie časového limitu a odložené vykonanie. Samotný stav hodnotu nezískava ani nehovorí, či sa výpočet skončil bez výnimky.
Verzia: 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 je enum class z <future>. Členské funkcie wait_for() a wait_until() tried std::future<T> a std::shared_future<T> vracajú tento typ. Prvá prijíma trvanie, druhá časový bod. Kontrolujú pripravenosť zdieľaného stavu, nie získanie výsledku.
std::future_status::ready znamená, že zdieľaný stav obsahuje hodnotu alebo výnimku pripravenú na získanie. Nezaručuje úspešný výpočet: get() môže uloženú výnimku znovu vyhodiť. std::future_status::timeout znamená, že čakanie sa skončilo uplynutím časového limitu; úlohu nezruší a nedokazuje, že úloha v čase kontroly stavu stále beží.
std::future_status::deferred znamená, že stav obsahuje odloženú funkciu, napríklad vytvorenú pomocou std::async(std::launch::deferred, ...). Čakanie s časovým limitom ju nespustí a vráti tento stav bez čakania na uplynutie limitu. Prvé čakanie bez časového limitu cez wait() alebo get() ju vykoná vo volajúcom vlákne. Cyklus, ktorý iba opakovane volá wait_for(), takúto úlohu nespustí.
Čakacie členské funkcie volajte len na objekte so zdieľaným stavom: valid() neznamená ready. Pri std::future<T> volanie get() spotrebuje výsledok a nastaví valid() == false; ďalšie čakanie na tomto objekte má nedefinované správanie. Príklad deterministicky kontroluje všetky tri stavy pomocou wait_for(0ms), prísľubu a výslovne odloženej úlohy, bez uspávania. Citované stránky predstavujú priebežne upravovaný pracovný návrh, nie nemenný text C++23.
Príklady
#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';
}
Výsledok
timeout: true ready: true deferred: true values: 42 7
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.