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.