CKTIS / C++
std::promise — transmettre une valeur ou une exception
std::promise<T> stocke un résultat unique dans un état partagé, lu au moyen de std::future<T>. Le résultat peut être une valeur ou une exception ; l’objet promise lui-même ne démarre ni calcul ni thread.
Version : 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> de <future> est la partie qui écrit le résultat, tandis que std::future<T> est la partie qui le reçoit. std::promise::get_future() renvoie un objet associé au même état partagé et ne peut être appelé qu’une fois pour cet état. Un promise peut être déplacé, mais pas copié ; il ne démarre pas lui-même de thread.
std::promise::set_value stocke une valeur et rend l’état prêt. Pour std::promise<T&>, il stocke une référence ; pour std::promise<void>, l’appel à set_value() signale la fin sans valeur. À la place, std::promise::set_exception stocke un std::exception_ptr non nul, par exemple obtenu avec std::current_exception() dans un bloc catch. future.get() attend que l’état soit prêt et récupère la valeur ou relance l’exception stockée. Le stockage du résultat est synchronisé avec le retour réussi de l’attente sur cet état.
Le résultat ne peut être défini avec succès qu’une seule fois : une nouvelle tentative déclenche std::future_error avec std::future_errc::promise_already_satisfied. Un nouvel appel à get_future() signale std::future_errc::future_already_retrieved ; l’absence d’état, par exemple après un déplacement, correspond à l’erreur std::future_errc::no_state. La destruction d’un promise dont l’état n’est pas prêt y stocke std::future_error avec std::future_errc::broken_promise et débloque le récepteur.
Exemples
#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';
}
}
Résultat
42 calculation failed
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.