CKTIS / C++
std::future: jednorázový asynchronní výsledek
std::future je přesouvatelný a nekopírovatelný úchyt jednoho sdíleného stavu s hodnotou nebo výjimkou.
Verze: C++23
Syntaxe
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> představuje výhradní přijímací stranu sdíleného stavu vytvořeného std::promise, std::packaged_task nebo std::async. wait() blokuje do připravenosti, zatímco wait_for a wait_until hlásí ready, timeout či deferred. std::future::get čeká a získá přesunutou hodnotu pro future<R>, referenci pro future<R&> nebo nic pro future<void>. std::future::share převede stav do shared_future a std::future::valid ověří, zda úchyt stále stav vlastní.
Příklad získá future z std::promise<int>, spustí vlákno ukládající 42 a zavolá result.get(). Nastavení hodnoty připraví stav a synchronizuje příjemce. get() vrátí 42 a pak stav uvolní, proto je result.valid() nepravda. Po join() program vypíše 42 0. Promise je zachycena referencí, ale žije až do ukončení vlákna.
std::future je jednorázové: po get(), share() nebo přesunu nemá zdroj stav. Volání většiny členů při valid() == false má nedefinované chování; doporučená detekce pomocí std::future_error(no_state) není zaručena. get() znovu vyhodí uloženou výjimku, zánik std::promise bez výsledku uloží broken_promise. Pro více příjemců použijte std::shared_future. Členy stejného future se navzájem nesynchronizují, proto s jedním objektem nepracujte souběžně.
Pří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ýsledek
42 0
std::future → 42 0