Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::future: jednorazový asynchrónny výsledok

std::future je presúvateľný a nekopírovateľný úchyt jedného zdieľaného stavu s hodnotou alebo výnimkou.

Verzia: C++23

Syntax

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> z <future> predstavuje výhradnú prijímaciu stranu zdieľaného stavu vytvoreného std::promise, std::packaged_task alebo std::async. wait() blokuje do pripravenosti, kým wait_for a wait_until hlásia ready, timeout či deferred. std::future::get čaká a získa presunutú hodnotu pre future<R>, referenciu pre future<R&> alebo nič pre future<void>. std::future::share prevedie stav do shared_future a std::future::valid overí, či úchyt stále má stav.

Príklad získa future z std::promise<int>, spustí vlákno ukladajúce 42 a zavolá result.get(). Nastavenie hodnoty pripraví stav a synchronizuje príjemcu. get() vráti 42 a potom stav uvoľní, preto je result.valid() nepravda. Po join() program vypíše 42 0. Promise je zachytená referenciou, ale žije až do konca vlákna.

std::future je jednorazové: po get(), share() alebo presune nemá zdroj stav. Volanie väčšiny členov pri valid() == false má nedefinované správanie; odporúčaná detekcia cez std::future_error(no_state) nie je zaručená. get() znova vyhodí uloženú výnimku a zánik std::promise bez výsledku uloží broken_promise. Pre viac príjemcov použite std::shared_future. Členy rovnakého future sa navzájom nesynchronizujú, preto s jedným objektom nepracujte súbežne.

Príklady

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

Výsledok

42 0

std::future → 42 0

Zdroje