std::future
De cppreference.com
<tbody>
</tbody>
| 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::futureal 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::futuredel 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) | |
| Destruye el objeto futuro (función miembro pública) | |
| Mueve el objeto futuro. (función miembro pública) | |
Transfiere el estado compartido de *this a un objeto shared_future y lo devuelve. (función miembro pública) | |
Obtener el resultado | |
| Devuelve el resultado. (función miembro pública) | |
Estado | |
| Comprueba si el objeto futuro tiene un estado compartido. (función miembro pública) | |
| Espera a que el resultado esté disponible. (función miembro pública) | |
| Espera el resultado, regresa si no está disponible durante el tiempo de espera especificado. (función miembro pública) | |
| Espera el resultado, regresa si no está disponible hasta que se haya alcanzado el punto de tiempo especificado. (función miembro pública) | |
Ejemplos
Ejecuta este código
#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
Ejecuta este código
#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
(C++11) |
Ejecuta una función asíncronamente (posiblemente en un nuevo hilo) y devuelve un std::future que contendrá el resultado. (plantilla de función) |
(C++11) |
Espera a un valor (posiblemente referenciado por otros futuros) que se ha establecido asíncronamente. (plantilla de clase) |