База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници