CKTIS / C++
std::future_status — rezultat časovno omejenega čakanja
std::future_status je enumeracija z določenim obsegom iz <future>, ki jo vračata wait_for() in wait_until(). Razlikuje pripravljen rezultat, potek časovne omejitve in odloženo izvajanje. Sam status ne pridobi vrednosti in ne pove, ali se je izračun končal brez izjeme.
Različica: 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>. Članski funkciji wait_for() in wait_until() razredov std::future<T> in std::shared_future<T> vračata ta tip. Prva sprejme trajanje, druga časovno točko. Preverjata, ali je skupno stanje pripravljeno, ne pridobivata pa rezultata.
std::future_status::ready pomeni, da skupno stanje vsebuje vrednost ali izjemo, pripravljeno za pridobitev. To ne zagotavlja uspešnega izračuna: get() lahko znova sproži shranjeno izjemo. std::future_status::timeout pomeni, da se je čakanje končalo zaradi poteka časovne omejitve; opravila ne prekliče in ne dokazuje, da opravilo še teče, ko preverite status.
std::future_status::deferred pomeni, da stanje vsebuje odloženo funkcijo, na primer tako, ki jo ustvari std::async(std::launch::deferred, ...). Čakanje s časovno omejitvijo je ne zažene in vrne ta status, ne da bi čakalo na potek omejitve. Prvo čakanje brez časovne omejitve prek wait() ali get() jo izvede v klicni niti. Zanka, ki samo preverja wait_for(), takega opravila ne bo zagnala.
Čakalne članske funkcije kličite samo na objektu s skupnim stanjem: valid() ne pomeni ready. Pri std::future<T> klic get() porabi rezultat in nastavi valid() == false; nadaljnje čakanje na tem objektu ima nedefinirano obnašanje. Primer deterministično preveri vse tri statuse z wait_for(0ms), obljubo in izrecno odloženim opravilom, brez uspavanja. Navedene strani predstavljajo sproti razvijani delovni osnutek, ne zamrznjenega besedila C++23.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.