CKTIS / C++
std::future: enkratni asinhroni rezultat
std::future je premakljiv in nekopirljiv ročaj do enega skupnega stanja z vrednostjo ali izjemo.
Različica: 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 izključni prejemni konec skupnega stanja, ki ga ustvari std::promise, std::packaged_task ali std::async. wait() blokira do pripravljenosti, wait_for in wait_until pa vrneta ready, timeout ali deferred. std::future::get počaka in pridobi premaknjeno vrednost za future<R>, referenco za future<R&> ali nič za future<void>. std::future::share prenese stanje v shared_future, std::future::valid pa preveri, ali ročaj še ima stanje.
Primer pridobi future iz std::promise<int>, zažene nit, ki nastavi 42, in pokliče result.get(). Nastavitev pripravi stanje in sinhronizira prejemnika. get() vrne 42 in nato sprosti stanje, zato je result.valid() neresničen. Po join() program izpiše 42 0. Promise je zajeta z referenco, vendar živi do konca niti.
std::future je enkraten: po get(), share() ali premiku vir nima stanja. Klic večine članov ob valid() == false ima nedefinirano vedenje; priporočeno zaznavanje z std::future_error(no_state) ni zagotovljeno. get() ponovno sproži shranjeno izjemo, uničenje std::promise brez rezultata pa shrani broken_promise. Za več prejemnikov uporabite std::shared_future. Člani istega future se med seboj ne sinhronizirajo, zato na enem objektu ne delajte sočasno.
Primeri
#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