std::shared_future::get

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de apoyo de concurrencia

Hilos thread (C++11) jthread (C++20) hardware_destructive_interference_sizehardware_constructive_interference_size (C++17)(C++17) Espacio de nombres this_thread get_id (C++11) yield (C++11) sleep_for (C++11) sleep_until (C++11) Cancelación cooperativa stop_token (C++20) inplace_stop_token (C++26) never_stop_token (C++26) stop_source (C++20) inplace_stop_source (C++26)   stop_callback (C++20) inplace_stop_callback (C++26) stop_callback_for_t (C++26) stoppable_token (C++26) unstoppable_token (C++26) stoppable-source (C++26) stoppable-callback-for (C++26)   Exclusión mutua mutex (C++11) recursive_mutex (C++11) shared_mutex (C++17) timed_mutex (C++11) recursive_timed_mutex (C++11) shared_timed_mutex (C++14) Gestión genérica de bloqueo lock (C++11) lock_guard (C++11) scoped_lock (C++17) unique_lock (C++11) shared_lock (C++14) once_flag (C++11) call_once (C++11) try_lock (C++11) defer_locktry_to_lockadopt_lockdefer_lock_ttry_to_lock_tadopt_lock_t (C++11)(C++11)(C++11)(C++11)(C++11)(C++11) Variables de condición condition_variable (C++11) condition_variable_any (C++11) notify_all_at_thread_exit (C++11) cv_status (C++11) Semáforos counting_semaphorebinary_semaphore (C++20)(C++20) Pestillos y barreras latch (C++20) barrier (C++20) Futuros promise (C++11) future (C++11) shared_future (C++11) packaged_task (C++11) async (C++11) launch (C++11) future_status (C++11) future_error (C++11) future_category (C++11) future_errc (C++11) Recuperación segura rcu_obj_base (C++26) rcu_domain (C++26) rcu_default_domain (C++26) rcu_synchronize (C++26) rcu_barrier (C++26) rcu_retire (C++26) Punteros de riesgo hazard_pointer_obj_base (C++26) hazard_pointer (C++26) make_hazard_pointer (C++26)

Tipos atómicos atomic (C++11) atomic_ref (C++20) atomic_flag (C++11) Inicialización de tipos atómicos atomic_init (C++11)(en desuso en C++20) ATOMIC_VAR_INIT (C++11)(en desuso en C++20) ATOMIC_FLAG_INIT (C++11) Orden de memoria memory_order (C++11) kill_dependency (C++11) atomic_thread_fence (C++11) atomic_signal_fence (C++11) Funciones independientes para operaciones atómicas atomic_storeatomic_store_explicit (C++11)(C++11) atomic_loadatomic_load_explicit (C++11)(C++11) atomic_exchangeatomic_exchange_explicit (C++11)(C++11) atomic_compare_exchange_weakatomic_compare_exchange_weak_explicitatomic_compare_exchange_strongatomic_compare_exchange_strong_explicit (C++11)(C++11)(C++11)(C++11) atomic_fetch_addatomic_fetch_add_explicit (C++11)(C++11) atomic_fetch_subatomic_fetch_sub_explicit (C++11)(C++11) atomic_fetch_andatomic_fetch_and_explicit (C++11)(C++11) atomic_fetch_oratomic_fetch_or_explicit (C++11)(C++11) atomic_fetch_xoratomic_fetch_xor_explicit (C++11)(C++11) atomic_fetch_maxatomic_fetch_max_explicit (C++26)(C++26) atomic_fetch_minatomic_fetch_min_explicit (C++26)(C++26) atomic_is_lock_free (C++11) atomic_waitatomic_wait_explicit (C++20)(C++20) atomic_notify_one (C++20) atomic_notify_all (C++20) Funciones independientes para indicadores atómicos atomic_flag_test_and_setatomic_flag_test_and_set_explicit (C++11)(C++11) atomic_flag_clearatomic_flag_clear_explicit (C++11)(C++11) atomic_flag_testatomic_flag_test_explicit (C++20)(C++20) atomic_flag_waitatomic_flag_wait_explicit (C++20)(C++20) atomic_flag_notify_one (C++20) atomic_flag_notify_all (C++20)

 

std::shared_future

Funciones miembro

shared_future::shared_future

shared_future::~shared_future

shared_future::operator=

Obtener el resultado

shared_future::get

Estado

shared_future::valid

shared_future::wait

shared_future::wait_for

shared_future::wait_until

 

const T& get()const;	(1)	(miembro solo de la plantilla genérica shared_future) (desde C++11)
T& get()const;	(2)	(miembro solo de la especialización de plantilla shared_future<T&>) (desde C++11)
void get()const;	(3)	(miembro solo de la especialización de plantilla shared_future<void>) (desde C++11)

La función miembro get espera hasta que el objeto shared_future tenga un resultado válido y (dependiendo de cual plantilla se use) lo recupera. Efectivamente llama a wait() para poder esperar el resultado.

La plantilla genérica y las dos especializaciones de plantilla, cada una contiene una sola versión de get. Las tres versiones de get solamente difieren en el tipo de retorno.

El comportamiento no está definido si valid() es false antes de la llamada a esta función.

Parámetros

(Ninguno)

Valor de retorno

1) Una referencia const al valor almacenado en el estado compartido. Acceder al valor a través de esta referencia no está definido después de que el estado compartido se haya destruido.

2) La referencia almacenada como valor en el estado compartido.

3) Nada.

Excepciones

Si una excepción estaba almacenada en el estado compartido referenciado por el objeto futuro (por ejemplo, mediante una llamada a std::promise::set_exception()) entonces la excepción se lanzará.

Notas

Se incentiva a las implementaciones a detectar el caso cuando valid() sea false antes de la llamada y lanzar std::future_error con un código de error std::future_errc::no_state.

Véase también

valid

Comprueba si el objeto futuro tiene un estado compartido. (función miembro pública)