CKTIS / C++
std::future_status — rezultat čekanja s vremenskim ograničenjem
std::future_status je enumeracija s definiranim opsegom iz <future>, koju vraćaju wait_for() i wait_until(). Razlikuje spreman rezultat, istek vremenskog ograničenja i odgođeno izvođenje. Sam status ne dohvaća vrijednost niti govori je li izračun završio bez iznimke.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 iz <future>. Članske funkcije wait_for() i wait_until() klasa std::future<T> i std::shared_future<T> vraćaju taj tip. Prva prima trajanje, a druga vremensku točku. Provjeravaju je li zajedničko stanje spremno, ali ne dohvaćaju rezultat.
std::future_status::ready znači da zajedničko stanje sadrži vrijednost ili iznimku spremnu za dohvaćanje. To ne jamči uspješan izračun: get() može ponovno izbaciti pohranjenu iznimku. std::future_status::timeout znači da je čekanje završilo istekom vremenskog ograničenja; ne otkazuje zadatak i ne dokazuje da zadatak još traje u trenutku provjere statusa.
std::future_status::deferred znači da stanje sadrži odgođenu funkciju, primjerice onu stvorenu pomoću std::async(std::launch::deferred, ...). Čekanje s vremenskim ograničenjem ne pokreće je i vraća taj status bez čekanja na istek ograničenja. Prvo čekanje bez vremenskog ograničenja putem wait() ili get() izvršava je u pozivnoj dretvi. Petlja koja samo provjerava wait_for() neće pokrenuti takav zadatak.
Članske funkcije za čekanje pozivajte samo na objektu sa zajedničkim stanjem: valid() ne znači ready. Za std::future<T>, poziv get() troši rezultat i postavlja valid() == false; daljnje čekanje na tom objektu ima nedefinirano ponašanje. Primjer deterministički provjerava sva tri statusa pomoću wait_for(0ms), obećanja i izričito odgođenog zadatka, bez uspavljivanja. Navedene stranice prikazuju radni nacrt koji se mijenja, a ne nepromjenjiv tekst C++23.
Primjeri
#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';
}
Rezultat
timeout: true ready: true deferred: true values: 42 7
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.