CKTIS / C++
std::promise — predaja vrijednosti ili iznimke
std::promise<T> pohranjuje jedan rezultat u zajedničko stanje koje se čita putem std::future<T>. Rezultat može biti vrijednost ili iznimka; sam objekt promise ne pokreće izračun ni dretvu.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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> iz zaglavlja <future> strana je koja zapisuje rezultat, dok je std::future<T> strana koja ga prima. std::promise::get_future() vraća objekt povezan s istim zajedničkim stanjem i za to se stanje može pozvati samo jednom. Promise se može premještati, ali ne i kopirati; sam ne pokreće dretvu.
std::promise::set_value pohranjuje vrijednost i označava stanje kao spremno. Za std::promise<T&> pohranjuje referencu; za std::promise<void> poziv set_value() signalizira dovršetak bez vrijednosti. Druga je mogućnost da std::promise::set_exception pohrani neprazan std::exception_ptr, primjerice dobiven s pomoću std::current_exception() unutar bloka catch. future.get() čeka da stanje postane spremno i dohvaća vrijednost ili ponovno baca pohranjenu iznimku. Pohrana rezultata sinkronizira se s uspješnim povratkom čekanja na to stanje.
Rezultat se može uspješno postaviti samo jednom: sljedeći pokušaj baca std::future_error s std::future_errc::promise_already_satisfied. Ponovni poziv get_future() prijavljuje std::future_errc::future_already_retrieved; nepostojanje stanja, primjerice nakon premještanja, uvjet je pogreške std::future_errc::no_state. Uništavanje promisea dok stanje nije spremno pohranjuje std::future_error s std::future_errc::broken_promise i odblokira primatelja.
Primjeri
#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';
}
}
Rezultat
42 calculation failed
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.