CKTIS / C++
std::future_status — резултат от изчакване с времево ограничение
std::future_status е изброим тип със зададен обхват от <future>, който се връща от wait_for() и wait_until(). Различава готов резултат, изтекло времево ограничение и отложено изпълнение. Самият статус не извлича стойността и не показва дали изчислението е завършило без изключение.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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 е enum class от <future>. Членовете wait_for() и wait_until() на std::future<T> и std::shared_future<T> връщат този тип. Първият приема продължителност, а вторият — момент във времето. Те проверяват дали споделеното състояние е готово, вместо да извличат резултата.
std::future_status::ready означава, че споделеното състояние съдържа стойност или изключение, готово за извличане. Това не гарантира успешно изчисление: get() може повторно да хвърли съхраненото изключение. std::future_status::timeout означава, че изчакването е приключило поради изтичане на времевото ограничение; то не отменя задачата и не доказва, че тя все още се изпълнява при проверката на статуса.
std::future_status::deferred означава, че състоянието съдържа отложена функция, например създадена чрез std::async(std::launch::deferred, ...). Изчакването с времево ограничение не я стартира и връща този статус, без да чака изтичането на ограничението. Първото изчакване без ограничение чрез wait() или get() я изпълнява в извикващата нишка. Цикъл, който само проверява wait_for(), няма да стартира такава задача.
Извиквайте функциите за изчакване само върху обект със споделено състояние: valid() не означава ready. При std::future<T> извикването на get() консумира резултата и оставя valid() == false; последващо изчакване върху този обект има неопределено поведение. Примерът детерминистично проверява и трите статуса чрез wait_for(0ms), promise и изрично отложена задача, без приспиване. Цитираните страници представят текущ работен проект, а не фиксиран текст на C++23.
Примери
#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';
}
Резултат
timeout: true ready: true deferred: true values: 42 7
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.