Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::future: jednokratni asinkroni rezultat

std::future je premjestiv i nekopirljiv rukohvat jednog dijeljenog stanja s vrijednošću ili iznimkom.

Verzija: C++23

Sintaksa

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> iz <future> predstavlja isključivu primateljsku stranu dijeljenog stanja koje stvara std::promise, std::packaged_task ili std::async. wait() blokira do spremnosti, dok wait_for i wait_until vraćaju ready, timeout ili deferred. std::future::get čeka i uzima premještenu vrijednost za future<R>, referencu za future<R&> ili ništa za future<void>. std::future::share prenosi stanje u shared_future, a std::future::valid provjerava ima li rukohvat još stanje.

Primjer dobiva future iz std::promise<int>, pokreće dretvu koja postavlja 42 i poziva result.get(). Postavljanje priprema stanje i sinkronizira primatelja. get() vraća 42 te oslobađa stanje, pa je result.valid() lažan. Nakon join() program ispisuje 42 0. Promise je uhvaćena referencom, ali živi do kraja dretve.

std::future je jednokratan: nakon get(), share() ili premještanja izvor nema stanje. Poziv većine članova kad je valid() == false ima nedefinirano ponašanje; preporučeno otkrivanje preko std::future_error(no_state) nije zajamčeno. get() ponovno baca spremljenu iznimku, a uništenje std::promise bez rezultata sprema broken_promise. Za više primatelja koristi std::shared_future. Članovi istog futurea ne sinkroniziraju se međusobno, stoga ne radi istodobno na jednom objektu.

Primjeri

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

Rezultat

42 0

std::future → 42 0

Izvori