Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::promise — entregar un valor o una excepción

std::promise<T> almacena un único resultado en un estado compartido que se lee mediante std::future<T>. El resultado puede ser un valor o una excepción; el propio objeto promise no inicia ningún cálculo ni hilo.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#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> es la parte que escribe el resultado, mientras que std::future<T> es la parte que lo recibe. std::promise::get_future() devuelve un objeto asociado al mismo estado compartido y solo puede llamarse una vez para ese estado. Un promise se puede mover, pero no copiar; no inicia ningún hilo por sí mismo.

std::promise::set_value almacena un valor y marca el estado como listo. Para std::promise<T&>, almacena una referencia; para std::promise<void>, llamar a set_value() indica que se ha completado sin un valor. Como alternativa, std::promise::set_exception almacena un std::exception_ptr no nulo, por ejemplo, obtenido con std::current_exception() dentro de un bloque catch. future.get() espera a que el estado esté listo y recupera el valor o vuelve a lanzar la excepción almacenada. El almacenamiento del resultado se sincroniza con el retorno satisfactorio de la espera sobre ese estado.

El resultado solo se puede establecer correctamente una vez: otro intento lanza std::future_error con std::future_errc::promise_already_satisfied. Volver a llamar a get_future() indica std::future_errc::future_already_retrieved; no tener estado, por ejemplo, después de mover el objeto, es la condición de error std::future_errc::no_state. Al destruir un promise cuyo estado aún no está listo, se almacena std::future_error con std::future_errc::broken_promise y se desbloquea al receptor.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes