Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::future_status — wynik oczekiwania z limitem czasu

std::future_status to wyliczenie zakresowe z nagłówka <future>, zwracane przez wait_for() i wait_until(). Rozróżnia gotowy wynik, upływ limitu czasu oraz odroczone wykonanie. Sam status nie pobiera wartości ani nie informuje, czy obliczenie zakończyło się bez wyjątku.

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

Składnia

#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 to enum class z nagłówka <future>. Metody wait_for() i wait_until() klas std::future<T> oraz std::shared_future<T> zwracają ten typ. Pierwsza przyjmuje czas trwania, druga — punkt w czasie. Służą do sprawdzania gotowości wspólnego stanu, a nie do pobierania wyniku.

std::future_status::ready oznacza, że wspólny stan zawiera wartość albo wyjątek gotowy do odebrania. Nie gwarantuje sukcesu obliczenia: get() może ponownie zgłosić zapisany wyjątek. std::future_status::timeout oznacza powrót z powodu upływu limitu czasu; nie anuluje zadania i nie dowodzi, że nadal ono działa w chwili analizowania statusu.

std::future_status::deferred oznacza, że stan zawiera odroczoną funkcję, na przykład utworzoną przez std::async(std::launch::deferred, ...). Oczekiwanie z limitem czasu jej nie uruchamia i zwraca ten status bez czekania na limit. Pierwsze oczekiwanie bez limitu, przez wait() albo get(), uruchamia ją w wątku wywołującym. Pętla odpytująca wyłącznie wait_for() nie uruchomi takiego zadania.

Wywołuj metody oczekiwania tylko dla obiektu mającego wspólny stan: valid() nie oznacza ready. Dla std::future<T> wywołanie get() zużywa wynik i pozostawia valid() == false; dalsze oczekiwanie na tym obiekcie ma niezdefiniowane zachowanie. Przykład deterministycznie sprawdza trzy statusy za pomocą wait_for(0ms), obietnicy i jawnie odroczonego zadania, bez usypiania wątku. Cytowane strony przedstawiają rozwijany szkic standardu, nie zamrożony tekst C++23.

Przykłady

#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';
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła