CKTIS / C++
std::promise — předání hodnoty nebo výjimky
std::promise<T> ukládá jediný výsledek do sdíleného stavu, který se čte prostřednictvím std::future<T>. Výsledkem může být hodnota nebo výjimka; samotný objekt promise nespouští výpočet ani vlákno.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <future>
std::promise<T> p;
std::future<T> f = p.get_future();
p.set_value(value); // success
// Alternatively: p.set_exception(exception_ptr);std::promise<T> z hlavičky <future> je strana zapisující výsledek, zatímco std::future<T> je strana, která jej přijímá. std::promise::get_future() vrací objekt spojený se stejným sdíleným stavem a pro daný stav jej lze zavolat pouze jednou. Promise lze přesouvat, ale nelze kopírovat; samo o sobě nespouští vlákno.
std::promise::set_value uloží hodnotu a označí stav jako připravený. U std::promise<T&> uloží referenci; u std::promise<void> volání set_value() signalizuje dokončení bez hodnoty. Alternativně std::promise::set_exception uloží nenulový std::exception_ptr, například získaný pomocí std::current_exception() uvnitř bloku catch. future.get() čeká, až bude stav připraven, a získá hodnotu, nebo znovu vyvolá uloženou výjimku. Uložení výsledku se synchronizuje s úspěšným návratem z čekání na tento stav.
Výsledek lze úspěšně nastavit pouze jednou: další pokus vyvolá std::future_error s std::future_errc::promise_already_satisfied. Opakované volání get_future() oznámí std::future_errc::future_already_retrieved; chybějící stav, například po přesunutí, je chybový stav std::future_errc::no_state. Při zničení promise s nepřipraveným stavem se uloží std::future_error s std::future_errc::broken_promise a čekající příjemce se odblokuje.
Příklady
#include <exception>
#include <future>
#include <iostream>
#include <stdexcept>
int main() {
std::promise<int> success;
auto value = success.get_future();
success.set_value(42);
std::cout << value.get() << '\n';
std::promise<int> failure;
auto error = failure.get_future();
try {
throw std::runtime_error("calculation failed");
} catch (...) {
failure.set_exception(std::current_exception());
}
try {
std::cout << error.get() << '\n';
} catch (const std::runtime_error& e) {
std::cout << e.what() << '\n';
}
}
Výsledek
42 calculation failed
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.