CKTIS / C++
std::future_status — výsledek čekání s časovým limitem
std::future_status je výčtový typ se silným určením oboru z <future>, který vracejí wait_for() a wait_until(). Rozlišuje připravený výsledek, vypršení časového limitu a odložené spuštění. Samotný stav hodnotu nezískává ani neříká, zda výpočet skončil bez výjimky.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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é funkce wait_for() a wait_until() tříd std::future<T> a std::shared_future<T> vracejí tento typ. První přijímá dobu trvání, druhá časový bod. Kontrolují připravenost sdíleného stavu, nikoli získání výsledku.
std::future_status::ready znamená, že sdílený stav obsahuje hodnotu nebo výjimku připravenou k získání. Nezaručuje úspěšný výpočet: get() může uloženou výjimku znovu vyhodit. std::future_status::timeout znamená, že čekání skončilo vypršením časového limitu; úlohu nezruší a nedokazuje, že úloha v okamžiku kontroly stavu stále běží.
std::future_status::deferred znamená, že stav obsahuje odloženou funkci, například vytvořenou pomocí std::async(std::launch::deferred, ...). Čekání s časovým limitem ji nespustí a vrátí tento stav, aniž by čekalo na uplynutí limitu. První čekání bez časového limitu přes wait() nebo get() ji provede ve volajícím vlákně. Smyčka, která pouze opakovaně volá wait_for(), takovou úlohu nespustí.
Čekací členské funkce volejte pouze na objektu se sdíleným stavem: valid() neznamená ready. U std::future<T> volání get() spotřebuje výsledek a nastaví valid() == false; další čekání na tomto objektu má nedefinované chování. Příklad deterministicky ověřuje všechny tři stavy pomocí wait_for(0ms), příslibu a výslovně odložené úlohy, bez uspávání. Citované stránky představují průběžně upravovaný pracovní návrh, nikoli neměnný text C++23.
Pří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ýsledek
timeout: true ready: true deferred: true values: 42 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.