CKTIS / C++
std::promise — fornire un valore o un’eccezione
std::promise<T> memorizza un singolo risultato in uno stato condiviso, letto tramite std::future<T>. Il risultato può essere un valore o un’eccezione; l’oggetto promise non avvia né un calcolo né un thread.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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> di <future> è la parte che scrive il risultato, mentre std::future<T> è quella che lo riceve. std::promise::get_future() restituisce un oggetto associato allo stesso stato condiviso e può essere chiamato una sola volta per quello stato. Un promise può essere spostato, ma non copiato; non avvia un thread autonomamente.
std::promise::set_value memorizza un valore e rende pronto lo stato. Per std::promise<T&> memorizza un riferimento; per std::promise<void>, la chiamata a set_value() segnala il completamento senza un valore. In alternativa, std::promise::set_exception memorizza un std::exception_ptr non nullo, per esempio ottenuto con std::current_exception() all’interno di un blocco catch. future.get() attende che lo stato sia pronto e recupera il valore oppure rilancia l’eccezione memorizzata. La memorizzazione del risultato è sincronizzata con il ritorno regolare dell’attesa su quello stato.
Il risultato può essere impostato correttamente una sola volta: un altro tentativo genera std::future_error con std::future_errc::promise_already_satisfied. Chiamare di nuovo get_future() segnala std::future_errc::future_already_retrieved; l’assenza di uno stato, per esempio dopo uno spostamento, corrisponde alla condizione di errore std::future_errc::no_state. Se un promise viene distrutto con uno stato non pronto, memorizza std::future_error con std::future_errc::broken_promise e sblocca il ricevente.
Esempi
#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';
}
}
Risultato
42 calculation failed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.