CKTIS / C++
std::promise — przekazywanie wartości lub wyjątku
std::promise<T> zapisuje pojedynczy wynik we współdzielonym stanie odczytywanym przez std::future<T>. Wynikiem może być wartość albo wyjątek; sam obiekt promise nie uruchamia obliczeń ani wątku.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 nagłówka <future> jest stroną zapisującą wynik, a std::future<T> — stroną odbierającą. std::promise::get_future() zwraca obiekt powiązany z tym samym współdzielonym stanem i można je wywołać tylko raz dla danego stanu. Obiekt promise można przenosić, ale nie kopiować; sam nie uruchamia wątku.
std::promise::set_value zapisuje wartość i oznacza stan jako gotowy. Dla std::promise<T&> zapisuje referencję, a dla std::promise<void> wywołanie set_value() sygnalizuje zakończenie bez wartości. Alternatywnie std::promise::set_exception zapisuje niepusty std::exception_ptr, na przykład z std::current_exception() wewnątrz catch. future.get() czeka na gotowość i odbiera wartość albo ponownie zgłasza zapisany wyjątek. Zapis wyniku synchronizuje się z pomyślnym zakończeniem oczekiwania na ten stan.
Wynik można skutecznie ustawić tylko raz: kolejna próba zgłasza std::future_error z std::future_errc::promise_already_satisfied. Ponowne get_future() zgłasza std::future_errc::future_already_retrieved; brak stanu, na przykład po przeniesieniu, jest warunkiem błędu std::future_errc::no_state. Zniszczenie promise z niegotowym stanem zapisuje std::future_error z std::future_errc::broken_promise i odblokowuje odbiorcę.
Przykłady
#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';
}
}
Wynik
42 calculation failed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.