CKTIS / C++
std::promise — предаване на стойност или изключение
std::promise<T> съхранява един резултат в споделено състояние, което се чете чрез std::future<T>. Резултатът може да бъде стойност или изключение; самият обект promise не стартира изчисление или нишка.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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> от <future> е страната, която записва резултата, а std::future<T> е страната, която го получава. std::promise::get_future() връща обект, свързан със същото споделено състояние, и може да бъде извикан само веднъж за това състояние. Promise може да бъде преместван, но не и копиран; самият той не стартира нишка.
std::promise::set_value съхранява стойност и маркира състоянието като готово. При std::promise<T&> съхранява препратка; при std::promise<void> извикването на set_value() сигнализира за завършване без стойност. Като алтернатива std::promise::set_exception съхранява ненулев std::exception_ptr, например получен чрез std::current_exception() в блок catch. future.get() изчаква състоянието да стане готово и получава стойността или повторно хвърля съхраненото изключение. Съхраняването на резултата се синхронизира с успешното връщане от изчакването на това състояние.
Резултатът може да бъде зададен успешно само веднъж: следващ опит хвърля std::future_error с std::future_errc::promise_already_satisfied. Повторно извикване на get_future() сигнализира std::future_errc::future_already_retrieved; липсата на състояние, например след преместване, е условието за грешка std::future_errc::no_state. Унищожаването на promise с все още неготово състояние съхранява std::future_error с std::future_errc::broken_promise и освобождава чакащия получател.
Примери
#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';
}
}
Резултат
42 calculation failed
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.