Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes