Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori