std:: future
From cppreference.net
C++
Concurrency support library
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
std::future
| Member functions | ||||
| Getting the result | ||||
| State | ||||
|
Definido en el 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 operaciones asíncronas:
-
Una operación asíncrona (creada mediante
std::async
,
std::packaged_task
, o
std::promise
) puede proporcionar un objeto
std::futureal creador de dicha operación asíncrona.
-
El creador de la operación asíncrona puede entonces utilizar diversos métodos para consultar, esperar o extraer un valor del
std::future. Estos métodos pueden bloquearse si la operación asíncrona aún no ha proporcionado un valor.
-
Cuando la operación asíncrona está lista para enviar un resultado al creador, puede hacerlo modificando el
estado compartido
(por ejemplo,
std::promise::set_value
) que está vinculado al
std::futuredel creador.
Tenga en cuenta que
std::future
hace referencia a un estado compartido que no se comparte con ningún otro objeto de retorno asíncrono (a diferencia de
std::shared_future
).
Contenidos |
Funciones miembro
|
construye el objeto future
(función miembro pública) |
|
|
destruye el objeto future
(función miembro pública) |
|
|
mueve el objeto future
(función miembro pública) |
|
|
transfiere el estado compartido desde
*
this
a un
shared_future
y lo devuelve
(función miembro pública) |
|
Obteniendo el resultado |
|
|
devuelve el resultado
(función miembro pública) |
|
Estado |
|
|
verifica si el future tiene un estado compartido
(función miembro pública) |
|
|
espera a que el resultado esté disponible
(función miembro pública) |
|
|
espera el resultado, retorna si no está disponible después de la duración de timeout especificada
(función miembro pública) |
|
|
espera el resultado, retorna si no está disponible hasta que se alcanza el punto de tiempo especificado
(función miembro pública) |
|
Ejemplos
Ejecutar este código
#include <future> #include <iostream> #include <thread> int main() { // future desde un packaged_task std::packaged_task<int()> task([]{ return 7; }); // envolver la función std::future<int> f1 = task.get_future(); // obtener un future std::thread t(std::move(task)); // lanzar en un hilo // future desde un async() std::future<int> f2 = std::async(std::launch::async, []{ return 8; }); // future desde una 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
Ejecutar este código
#include <future> #include <iostream> #include <thread> int main() { std::promise<int> p; std::future<int> f = p.get_future(); std::thread t([&p] { try { // código que puede lanzar excepciones throw std::runtime_error("Example"); } catch (...) { try { // almacenar cualquier excepción en la 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:
Exception from the thread: Example
Véase también
|
(C++11)
|
ejecuta una función asincrónicamente (potencialmente en un nuevo hilo) y devuelve un
std::future
que contendrá el resultado
(plantilla de función) |
|
(C++11)
|
espera por un valor (posiblemente referenciado por otros futures) que se establece asincrónicamente
(plantilla de clase) |