Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::future_status — výsledek čekání s časovým limitem

std::future_status je výčtový typ se silným určením oboru z <future>, který vracejí wait_for() a wait_until(). Rozlišuje připravený výsledek, vypršení časového limitu a odložené spuštění. Samotný stav hodnotu nezískává ani neříká, zda výpočet skončil bez výjimky.

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

Syntaxe

#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é funkce wait_for() a wait_until() tříd std::future<T> a std::shared_future<T> vracejí tento typ. První přijímá dobu trvání, druhá časový bod. Kontrolují připravenost sdíleného stavu, nikoli získání výsledku.

std::future_status::ready znamená, že sdílený stav obsahuje hodnotu nebo výjimku připravenou k získání. Nezaručuje úspěšný výpočet: get() může uloženou výjimku znovu vyhodit. std::future_status::timeout znamená, že čekání skončilo vypršením časového limitu; úlohu nezruší a nedokazuje, že úloha v okamžiku kontroly stavu stále běží.

std::future_status::deferred znamená, že stav obsahuje odloženou funkci, například vytvořenou pomocí std::async(std::launch::deferred, ...). Čekání s časovým limitem ji nespustí a vrátí tento stav, aniž by čekalo na uplynutí limitu. První čekání bez časového limitu přes wait() nebo get() ji provede ve volajícím vlákně. Smyčka, která pouze opakovaně volá wait_for(), takovou úlohu nespustí.

Čekací členské funkce volejte pouze na objektu se sdíleným stavem: valid() neznamená ready. U std::future<T> volání get() spotřebuje výsledek a nastaví valid() == false; další čekání na tomto objektu má nedefinované chování. Příklad deterministicky ověřuje všechny tři stavy pomocí wait_for(0ms), příslibu a výslovně odložené úlohy, bez uspávání. Citované stránky představují průběžně upravovaný pracovní návrh, nikoli neměnný text C++23.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje