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

CKTIS / C++

std::future: еднократен асинхронен резултат

std::future е преместваема и некопируема дръжка към едно споделено състояние със стойност или изключение.

Версия: C++23

Синтаксис

template<class R> class std::future {
public:
    future() noexcept;
    future(future&&) noexcept;
    future(const future&) = delete;

    R get();
    bool valid() const noexcept;
    void wait() const;
    template<class Rep, class Period>
    std::future_status wait_for(const std::chrono::duration<Rep, Period>& timeout) const;

    std::shared_future<R> share() noexcept;
};

std::future<R> от <future> е изключителният приемащ край на споделено състояние, създадено от std::promise, std::packaged_task или std::async. wait() блокира до готовност, а wait_for и wait_until връщат ready, timeout или deferred. std::future::get чака и взема преместена стойност за future<R>, референция за future<R&> или нищо за future<void>. std::future::share прехвърля състоянието в shared_future, а std::future::valid проверява дали дръжката още има състояние.

Примерът получава future от std::promise<int>, стартира нишка, която задава 42, и извиква result.get(). Задаването подготвя състоянието и синхронизира приемника. get() връща 42 и освобождава състоянието, затова result.valid() е false. След join() програмата извежда 42 0. Promise е прихванат по референция, но живее до края на нишката.

std::future е еднократен: след get(), share() или преместване източникът няма състояние. Извикването на повечето членове при valid() == false има неопределено поведение; препоръчаното откриване с std::future_error(no_state) не е гарантирано. get() хвърля отново запазено изключение, а унищожаването на std::promise без резултат записва broken_promise. За много приемници използвайте std::shared_future. Членовете на същия future не се синхронизират взаимно, затова не работете едновременно върху един обект.

Примери

#include <future>
#include <iostream>
#include <thread>

int main() {
    std::promise<int> promise;
    std::future<int> result = promise.get_future();
    std::thread producer([&promise] { promise.set_value(42); });

    const int value = result.get();
    producer.join();
    std::cout << value << ' ' << result.valid() << '\n';
}

Резултат

42 0

std::future → 42 0

Източници