Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::future_status — výsledok čakania s časovým limitom

std::future_status je výčtový typ s určeným rozsahom z <future>, ktorý vracajú wait_for() a wait_until(). Rozlišuje pripravený výsledok, uplynutie časového limitu a odložené vykonanie. Samotný stav hodnotu nezískava ani nehovorí, či sa výpočet skončil bez výnimky.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#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é funkcie wait_for() a wait_until() tried std::future<T> a std::shared_future<T> vracajú tento typ. Prvá prijíma trvanie, druhá časový bod. Kontrolujú pripravenosť zdieľaného stavu, nie získanie výsledku.

std::future_status::ready znamená, že zdieľaný stav obsahuje hodnotu alebo výnimku pripravenú na získanie. Nezaručuje úspešný výpočet: get() môže uloženú výnimku znovu vyhodiť. std::future_status::timeout znamená, že čakanie sa skončilo uplynutím časového limitu; úlohu nezruší a nedokazuje, že úloha v čase kontroly stavu stále beží.

std::future_status::deferred znamená, že stav obsahuje odloženú funkciu, napríklad vytvorenú pomocou std::async(std::launch::deferred, ...). Čakanie s časovým limitom ju nespustí a vráti tento stav bez čakania na uplynutie limitu. Prvé čakanie bez časového limitu cez wait() alebo get() ju vykoná vo volajúcom vlákne. Cyklus, ktorý iba opakovane volá wait_for(), takúto úlohu nespustí.

Čakacie členské funkcie volajte len na objekte so zdieľaným stavom: valid() neznamená ready. Pri std::future<T> volanie get() spotrebuje výsledok a nastaví valid() == false; ďalšie čakanie na tomto objekte má nedefinované správanie. Príklad deterministicky kontroluje všetky tri stavy pomocou wait_for(0ms), prísľubu a výslovne odloženej úlohy, bez uspávania. Citované stránky predstavujú priebežne upravovaný pracovný návrh, nie nemenný text C++23.

Prí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ýsledok

timeout: true
ready: true
deferred: true
values: 42 7

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje