◐ Shell
clean mode source ↗

std::future - cppreference.com

De cppreference.com

Definido en el archivo de encabezado <future>

template< class T > class future;

 (1) (desde C++11)

template< class T > class future<T&>;

 (2) (desde C++11)

template<> class future<void>;

 (3) (desde C++11)

La plantilla de clase std::future proporciona un mecanismo para acceder al resultado de las operaciones asincrónicas:

  • Una operación asincrónica (creada a través de std::async, std::packaged_task, o std::promise) puede proporcionar un objeto std::future al creador de esa operación asincrónica.
  • El creador de la operación asincrónica puede entonces usar una variedad de métodos para consultar, esperar o extraer un valor de std::future. Estos métodos pueden bloquearse si la operación asincrónica aún no ha proporcionado un valor.
  • Cuando la operación asincrónica está lista para enviar un resultado al creador, puede hacerlo modificando el estado compartido (por ejemplo, std::promise::set_value) que está vinculado al objeto std::future del creador.

Ten en cuenta que std::future hace referencia al estado compartido que no se comparte con ningún otro objeto de retorno asincrónico (a diferencia de std::shared_future).

Funciones miembro

Construye el objeto futuro.
(función miembro pública) [editar]
Destruye el objeto futuro
(función miembro pública) [editar]
Mueve el objeto futuro.
(función miembro pública) [editar]
Transfiere el estado compartido de *this a un objeto shared_future y lo devuelve.
(función miembro pública) [editar]
Obtener el resultado
Devuelve el resultado.
(función miembro pública) [editar]
Estado
Comprueba si el objeto futuro tiene un estado compartido.
(función miembro pública) [editar]
Espera a que el resultado esté disponible.
(función miembro pública) [editar]
Espera el resultado, regresa si no está disponible durante el tiempo de espera especificado.
(función miembro pública) [editar]
Espera el resultado, regresa si no está disponible hasta que se haya alcanzado el punto de tiempo especificado.
(función miembro pública) [editar]

Ejemplos

#include <iostream>
#include <future>
#include <thread>

int main()
{
    // future a partir de packaged_task
    std::packaged_task<int()> task([]{ return 7; }); // envolver la función
    std::future<int> f1 = task.get_future();  // obtener un objeto future
    std::thread t(std::move(task)); // lanzar en un hilo

    // future a partir de async()
    std::future<int> f2 = std::async(std::launch::async, []{ return 8; });

    // future a partir de promise
    std::promise<int> p;
    std::future<int> f3 = p.get_future();
    std::thread( [&p]{ p.set_value_at_thread_exit(9); }).detach();

    std::cout << "Esperando..." << std::flush;
    f1.wait();
    f2.wait();
    f3.wait();
    std::cout << "¡Listo!\nLos resultados son: "
              << f1.get() << ' ' << f2.get() << ' ' << f3.get() << '\n';
    t.join();
}

Salida: 

Esperando...¡Listo!
Los resultados son: 7 8 9

Ejemplo con excepciones

#include <thread>
#include <iostream>
#include <future>

int main()
{
    std::promise<int> p;
    std::future<int> f = p.get_future();

    std::thread t([&p]{
        try {
            // código que puede lanzar una excepción
            throw std::runtime_error("Ejemplo");
        } catch(...) {
            try {
                // almacena cualquier cosa lanzada en el objeto promesa
                p.set_exception(std::current_exception());
            } catch(...) {} // set_exception() también puede lanzar
        }
    });

    try {
        std::cout << f.get();
    } catch(const std::exception& e) {
        std::cout << "Excepción desde el hilo: " << e.what() << '\n';
    }
    t.join();
}

Salida: 

Excepción desde el hilo: Ejemplo

Véase también

Ejecuta una función asíncronamente (posiblemente en un nuevo hilo) y devuelve un std::future que contendrá el resultado.
(plantilla de función) [editar]
Espera a un valor (posiblemente referenciado por otros futuros) que se ha establecido asíncronamente.
(plantilla de clase) [editar]