CKTIS / C++
std::future: eenmalig asynchroon resultaat
std::future is een verplaatsbare, niet-kopieerbare handle naar één gedeelde toestand met een waarde of exceptie.
Versie: 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> uit <future> vormt de exclusieve ontvangkant van gedeelde toestand die door std::promise, std::packaged_task of std::async is gemaakt. wait() blokkeert tot gereed; wait_for en wait_until melden ready, timeout of deferred. std::future::get wacht en neemt een verplaatste waarde voor future<R>, een referentie voor future<R&> of niets voor future<void>. std::future::share draagt de toestand over aan een shared_future, en std::future::valid controleert of de handle nog een toestand bezit.
Het voorbeeld verkrijgt een future van std::promise<int>, start een thread die 42 opslaat en roept result.get() aan. De waarde gereedmaken synchroniseert de ontvanger. get() levert 42 en geeft daarna de toestand vrij, zodat result.valid() onwaar is. Na join() print het programma 42 0. De promise is per referentie gevangen, maar leeft tot de thread klaar is.
std::future is eenmalig: na get(), share() of verplaatsen heeft de bron geen toestand. De meeste leden aanroepen wanneer valid() == false is ongedefinieerd gedrag; aanbevolen detectie via std::future_error(no_state) is niet gegarandeerd. get() werpt een opgeslagen exceptie opnieuw; vernietiging van std::promise zonder resultaat bewaart broken_promise. Gebruik std::shared_future voor meerdere ontvangers. Leden op dezelfde future synchroniseren niet onderling; werk dus niet gelijktijdig op één object.
Voorbeelden
#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';
}
Resultaat
42 0
std::future → 42 0