Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri