CKTIS / C++
std::promise — fornecer um valor ou uma exceção
std::promise<T> armazena um único resultado num estado partilhado, lido através de std::future<T>. O resultado pode ser um valor ou uma exceção; o próprio objeto promise não inicia qualquer cálculo nem thread.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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> é a parte que escreve o resultado, enquanto std::future<T> é a parte que o recebe. std::promise::get_future() devolve um objeto associado ao mesmo estado partilhado e só pode ser chamado uma vez para esse estado. Um promise pode ser movido, mas não copiado; não inicia um thread por si próprio.
std::promise::set_value armazena um valor e marca o estado como pronto. Para std::promise<T&>, armazena uma referência; para std::promise<void>, chamar set_value() assinala a conclusão sem um valor. Em alternativa, std::promise::set_exception armazena um std::exception_ptr não nulo, por exemplo, obtido com std::current_exception() dentro de um bloco catch. future.get() espera até o estado estar pronto e obtém o valor ou volta a lançar a exceção armazenada. O armazenamento do resultado sincroniza com o retorno bem-sucedido da espera por esse estado.
O resultado só pode ser definido com sucesso uma vez: uma nova tentativa lança std::future_error com std::future_errc::promise_already_satisfied. Chamar novamente get_future() indica std::future_errc::future_already_retrieved; não existir um estado, por exemplo após uma operação de movimento, é a condição de erro std::future_errc::no_state. A destruição de um promise com um estado ainda não pronto armazena std::future_error com std::future_errc::broken_promise e desbloqueia o recetor.
Exemplos
#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';
}
}
Resultado
42 calculation failed
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.