Concurrency support library

C++ incluye soporte incorporado para hilos, operaciones atómicas, exclusión mutua, variables de condición y almacenamientos específicos de hilo.

Estas características se proporcionan opcionalmente:

• si la constante de macro __STDC_NO_THREADS__ está definida por el compilador, el encabezado <threads.h> y todos los nombres proporcionados en él no están disponibles;
• si la constante de macro __STDC_NO_ATOMICS__ está definida por el compilador, el encabezado <stdatomic.h> y todos los nombres proporcionados en él no están disponibles.

Véase también _Atomic especificador de tipo y calificador .

Contenidos 1 Hilos 2 Operaciones atómicas 2.1 Operaciones sobre tipos atómicos 2.2 Tipo bandera y operaciones 2.3 Inicialización 2.4 Ordenamiento de sincronización de memoria 2.5 Alias de tipos de conveniencia 3 Exclusión mutua 3.1 Llamada única 4 Variables de condición 5 Almacenamiento local de hilo 6 Identificadores reservados 7 Referencias 8 Véase también 9 Enlaces externos

Hilos

Definido en el encabezado <threads.h>
thrd_t	tipo de objeto completo definido por la implementación que identifica un hilo
thrd_create (C11)	crea un hilo (función)
thrd_equal (C11)	comprueba si dos identificadores se refieren al mismo hilo (función)
thrd_current (C11)	obtiene el identificador del hilo actual (función)
thrd_sleep (C11)	suspende la ejecución del hilo llamante durante el período de tiempo dado (función)
thrd_yield (C11)	cede el segmento de tiempo actual (función)
thrd_exit (C11)	termina el hilo llamante (función)
thrd_detach (C11)	separa un hilo (función)
thrd_join (C11)	bloquea hasta que un hilo termina (función)
thrd_success thrd_timedout thrd_busy thrd_nomem thrd_error (C11)	indica un estado de error del hilo (constante)
thrd_start_t (C11)	un typedef del tipo puntero a función int ( * ) ( void * ) , utilizado por thrd_create (typedef)

Operaciones atómicas

Definido en el encabezado <stdatomic.h>
Operaciones sobre tipos atómicos
ATOMIC_BOOL_LOCK_FREE ATOMIC_CHAR_LOCK_FREE ATOMIC_CHAR16_T_LOCK_FREE ATOMIC_CHAR32_T_LOCK_FREE ATOMIC_WCHAR_T_LOCK_FREE ATOMIC_SHORT_LOCK_FREE ATOMIC_INT_LOCK_FREE ATOMIC_LONG_LOCK_FREE ATOMIC_LLONG_LOCK_FREE ATOMIC_POINTER_LOCK_FREE (C11)	indica que el tipo atómico dado es libre de bloqueo (constante macro)
atomic_is_lock_free (C11)	indica si el objeto atómico está libre de bloqueo (función)
atomic_store atomic_store_explicit (C11)	almacena un valor en un objeto atómico (función)
atomic_load atomic_load_explicit (C11)	lee un valor de un objeto atómico (función)
atomic_exchange atomic_exchange_explicit (C11)	intercambia un valor con el valor de un objeto atómico (función)
atomic_compare_exchange_strong atomic_compare_exchange_strong_explicit atomic_compare_exchange_weak atomic_compare_exchange_weak_explicit (C11)	intercambia un valor con un objeto atómico si el valor antiguo coincide con lo esperado, de lo contrario lee el valor antiguo (función)
atomic_fetch_add atomic_fetch_add_explicit (C11)	suma atómica (función)
atomic_fetch_sub atomic_fetch_sub_explicit (C11)	resta atómica (función)
atomic_fetch_or atomic_fetch_or_explicit (C11)	OR atómico bit a bit (función)
atomic_fetch_xor atomic_fetch_xor_explicit (C11)	OR exclusivo atómico bit a bit (función)
atomic_fetch_and atomic_fetch_and_explicit (C11)	AND atómico bit a bit (función)
Tipo de bandera y operaciones
atomic_flag (C11)	bandera atómica booleana libre de bloqueo (struct)
atomic_flag_test_and_set atomic_flag_test_and_set_explicit (C11)	establece un atomic_flag a verdadero y devuelve el valor anterior (función)
atomic_flag_clear atomic_flag_clear_explicit (C11)	establece un atomic_flag a falso (función)
Inicialización
atomic_init (C11)	inicializa un objeto atómico existente (función)
ATOMIC_VAR_INIT (C11) (obsoleto en C17) (eliminado en C23)	inicializa un nuevo objeto atómico (macro de función)
ATOMIC_FLAG_INIT (C11)	inicializa un nuevo atomic_flag (macro constante)
Orden de sincronización de memoria
memory_order (C11)	define las restricciones de ordenamiento de memoria (enum)
kill_dependency (C11)	rompe una cadena de dependencia para memory_order_consume (macro de función)
atomic_thread_fence (C11)	primitiva de sincronización de barrera genérica dependiente del orden de memoria (función)
atomic_signal_fence (C11)	barrera entre un hilo y un manejador de señales ejecutado en el mismo hilo (función)

Alias de tipos de conveniencia
Nombre del typedef	Nombre completo del tipo
atomic_bool (C11)	_Atomic _Bool (hasta C23) _Atomic bool (desde C23)
atomic_char (C11)	_Atomic char
atomic_schar (C11)	_Atomic signed char
atomic_uchar (C11)	_Atomic unsigned char
atomic_short (C11)	_Atomic short
atomic_ushort (C11)	_Atomic unsigned short
atomic_int (C11)	_Atomic int
atomic_uint (C11)	_Atomic unsigned int
atomic_long (C11)	_Atomic long
atomic_ulong (C11)	_Atomic unsigned long
atomic_llong (C11)	_Atomic long long
atomic_ullong (C11)	_Atomic unsigned long long
atomic_char8_t (C23)	_Atomic char8_t
atomic_char16_t (C11)	_Atomic char16_t
atomic_char32_t (C11)	_Atomic char32_t
atomic_wchar_t (C11)	_Atomic wchar_t
atomic_int_least8_t (C11)	_Atomic int_least8_t
atomic_uint_least8_t (C11)	_Atomic uint_least8_t
atomic_int_least16_t (C11)	_Atomic int_least16_t
atomic_uint_least16_t (C11)	_Atomic uint_least16_t
atomic_int_least32_t (C11)	_Atomic int_least32_t
atomic_uint_least32_t (C11)	_Atomic uint_least32_t
atomic_int_least64_t (C11)	_Atomic int_least64_t
atomic_uint_least64_t (C11)	_Atomic uint_least64_t
atomic_int_fast8_t (C11)	_Atomic int_fast8_t
atomic_uint_fast8_t (C11)	_Atomic uint_fast8_t
atomic_int_fast16_t (C11)	_Atomic int_fast16_t
atomic_uint_fast16_t (C11)	_Atomic uint_fast16_t
atomic_int_fast32_t (C11)	_Atomic int_fast32_t
atomic_uint_fast32_t (C11)	_Atomic uint_fast32_t
atomic_int_fast64_t (C11)	_Atomic int_fast64_t
atomic_uint_fast64_t (C11)	_Atomic uint_fast64_t
atomic_intptr_t (C11)	_Atomic intptr_t
atomic_uintptr_t (C11)	_Atomic uintptr_t
atomic_size_t (C11)	_Atomic size_t
atomic_ptrdiff_t (C11)	_Atomic ptrdiff_t
atomic_intmax_t (C11)	_Atomic intmax_t
atomic_uintmax_t (C11)	_Atomic uintmax_t

Exclusión mutua

Definido en el encabezado <threads.h>
mtx_t	identificador de mutex
mtx_init (C11)	crea un mutex (función)
mtx_lock (C11)	bloquea hasta adquirir un mutex (función)
mtx_timedlock (C11)	bloquea hasta adquirir un mutex o se agota el tiempo (función)
mtx_trylock (C11)	adquiere un mutex o retorna sin bloquear si ya está bloqueado (función)
mtx_unlock (C11)	libera un mutex (función)
mtx_destroy (C11)	destruye un mutex (función)
mtx_plain mtx_recursive mtx_timed (C11) (C11) (C11)	define el tipo de un mutex (enumeración)
Ejecución única
call_once (C11)	llama a una función exactamente una vez (función)

Variables de condición

Definido en el encabezado <threads.h>
cnd_t	identificador de variable de condición
cnd_init (C11)	crea una variable de condición (función)
cnd_signal (C11)	desbloquea un hilo bloqueado en una variable de condición (función)
cnd_broadcast (C11)	desbloquea todos los hilos bloqueados en una variable de condición (función)
cnd_wait (C11)	bloquea en una variable de condición (función)
cnd_timedwait (C11)	bloquea en una variable de condición, con un tiempo de espera (función)
cnd_destroy (C11)	destruye una variable de condición (función)

Almacenamiento local de hilo

Definido en el encabezado <threads.h>
thread_local (C11) (eliminado en C23)	macro de conveniencia para el especificador de clase de almacenamiento _Thread_local (macro de palabra clave)
tss_t	puntero de almacenamiento específico del hilo
TSS_DTOR_ITERATIONS (C11)	número máximo de veces que se llaman los destructores (constante macro)
tss_dtor_t (C11)	tipo de puntero a función void ( * ) ( void * ) , utilizado para el destructor TSS (typedef)
tss_create (C11)	crea un puntero de almacenamiento específico del hilo con un destructor dado (función)
tss_get (C11)	lee del almacenamiento específico del hilo (función)
tss_set (C11)	escribe en el almacenamiento específico del hilo (función)
tss_delete (C11)	libera los recursos mantenidos por un puntero específico del hilo dado (función)

Identificadores reservados

En futuras revisiones del estándar C:

• Los nombres de función, nombres de tipo y constantes de enumeración que comienzan con cnd_ , mtx_ , thrd_ , o tss_ , y una letra minúscula pueden añadirse a las declaraciones en el encabezado <threads.h> ;
• Las macros que comienzan con ATOMIC_ y una letra mayúscula pueden añadirse a las macros definidas en el encabezado <stdatomic.h> ;
• Los nombres de tipo definidos que comienzan con atomic_ o memory_ , y una letra minúscula pueden añadirse a las declaraciones en el encabezado <stdatomic.h> ;
• Las constantes de enumeración que comienzan con memory_order_ y una letra minúscula pueden añadirse a la definición del tipo memory_order en el encabezado <stdatomic.h> ;
• Los nombres de función que comienzan con atomic_ y una letra minúscula pueden añadirse a las declaraciones en el encabezado <stdatomic.h> .

Los identificadores reservados para nombres de funciones siempre están potencialmente (since C23) reservados para su uso como identificadores con enlace externo, mientras que otros identificadores listados aquí están potencialmente (since C23) reservados cuando se incluye <stdatomic.h> .

Declarar, definir, o #undef ese identificador resulta en comportamiento indefinido si es proporcionado por el estándar o la implementación (desde C23) . Los programas portables no deben usar esos identificadores.

Referencias

Véase también

Documentación de C++ para Biblioteca de soporte para concurrencia

Enlaces externos

Manual de GNU GCC Libc: Mutexes ISO C