std::atomic_ref<T>::wait

 

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 operaciones atómicas

Tipos

atomic (C++11)

atomic_ref (C++20)

Funciones

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_is_lock_free (C++11)

atomic_waitatomic_wait_explicit (C++20)(C++20)

atomic_notify_one (C++20)

atomic_notify_all (C++20)

Banderas atómicas

atomic_flag (C++11)

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)

Inicialización

atomic_init (C++11)(en desuso en C++20)

ATOMIC_VAR_INIT (C++11)(en desuso en C++20)

ATOMIC_FLAG_INIT (C++11)(en desuso en C++20)

Ordenamiento de memoria

memory_order (C++11)

kill_dependency (C++11)

atomic_thread_fence (C++11)

atomic_signal_fence (C++11)

 

std::atomic_ref

Funciones miembro

atomic_ref::atomic_ref

atomic_ref::operator=

atomic_ref::is_lock_free

atomic_ref::store

atomic_ref::load

atomic_ref::operator T

atomic_ref::exchange

atomic_ref::compare_exchange_strongatomic_ref::compare_exchange_weak

atomic_ref::wait (C++20)

atomic_ref::notify_one (C++20)

atomic_ref::notify_all (C++20)

Constantes

atomic_ref::is_always_lock_free

atomic_ref::required_alignment

Funciones miembro especializadas

atomic_ref::fetch_add

atomic_ref::fetch_sub

atomic_ref::fetch_and

atomic_ref::fetch_or

atomic_ref::fetch_xor

atomic_ref::operator++atomic_ref::operator++(int)atomic_ref::operator--atomic_ref::operator--(int)

atomic_ref::operator+=atomic_ref::operator-=atomic_ref::operator&=atomic_ref::operator|=atomic_ref::operator^=

 

		(desde C++20)
void wait( T old,            std::memory_order order = std::memory_order::seq_cst)constnoexcept;
void wait( T old,            std::memory_order order = std::memory_order::seq_cst)constvolatilenoexcept;

Realiza operaciones atómicas de espera. Se comporta como si repetidamente realizara los siguientes pasos:

• Compara la representación del valor de this->load(order) con la de old.
  • Si son iguales, entonces se bloquea hasta que *this es notificado mediante notify_one() o notify_all(), o el hilo se desbloquea falsamente (spuriously).
  • De otra forma, regresa.

Se garantiza que estas funciones solamente regresan si el valor ha cambiado, aun si la implementación subyacente desbloquea falsamente.

Parámetros

old	-	El valor a comprobar que el objeto de atomic_ref ya no contenga.
order	-	El orden de sincronización de memoria para esta operación. No debe ser std::memory_order::release o std::memory_order::acq_rel

Valor de retorno

(Ninguno)

Notas

Esta forma de detección de cambio frecuentemente es más eficiente que un simple sondeo (polling) o cerrojos de espín (spinlocks).

Debido al problema ABA, cambios transitorios de old a otro valor y de regreso a old pueden perderse, y no desbloquear.

La comparación es bit a bit (similar a std::memcpy); no se utiliza un operador de comparación. Los bits de relleno que nunca participan en la representación del valor de un objeto se ignoran.

Véase también

notify_one (C++20)	Notifica al menos a un hilo/subproceso esperando al objeto atómico. (función miembro pública)
notify_all (C++20)	Notifica a todos los hilos/subprocesos bloqueados esperando al objeto atómico. (función miembro pública)
atomic_notify_one (C++20)	Notifica a un hilo bloqueado en atomic_wait. (plantilla de función)
atomic_notify_all (C++20)	Notifica a todos los hilos bloqueados en atomic_wait. (plantilla de función)