CKTIS / C++
std::promise — posredovanje vrednosti ali izjeme
std::promise<T> shrani en rezultat v skupno stanje, ki se bere prek std::future<T>. Rezultat je lahko vrednost ali izjema; objekt promise sam ne zažene izračuna ali niti.
Različica: 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 <future> je stran, ki zapisuje rezultat, medtem ko je std::future<T> stran, ki ga prejme. std::promise::get_future() vrne objekt, povezan z istim skupnim stanjem, in ga je za to stanje mogoče poklicati samo enkrat. Promise je mogoče premakniti, ni pa ga mogoče kopirati; samo po sebi ne zažene niti.
std::promise::set_value shrani vrednost in stanje označi kot pripravljeno. Pri std::promise<T&> shrani referenco; pri std::promise<void> klic set_value() označi dokončanje brez vrednosti. Druga možnost je, da std::promise::set_exception shrani neničelni std::exception_ptr, na primer pridobljen z std::current_exception() znotraj bloka catch. future.get() počaka, da je stanje pripravljeno, in pridobi vrednost ali znova sproži shranjeno izjemo. Shranjevanje rezultata se sinhronizira z uspešno vrnitvijo čakanja na to stanje.
Rezultat je mogoče uspešno nastaviti samo enkrat: naslednji poskus sproži std::future_error z std::future_errc::promise_already_satisfied. Ponovni klic get_future() sporoči std::future_errc::future_already_retrieved; odsotnost stanja, na primer po premiku, je napaka std::future_errc::no_state. Če se promise uniči, ko stanje še ni pripravljeno, shrani std::future_error z std::future_errc::broken_promise in odblokira prejemnika.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.