Concurrency support library

C++ inclut une prise en charge intégrée pour les threads, les opérations atomiques, les exclusions mutuelles, les variables de condition et les stockages spécifiques aux threads.

Ces fonctionnalités sont fournies en option :

• si la constante de macro __STDC_NO_THREADS__ est définie par le compilateur, l'en-tête <threads.h> et tous les noms qu'il fournit ne sont pas disponibles ;
• si la constante de macro __STDC_NO_ATOMICS__ est définie par le compilateur, l'en-tête <stdatomic.h> et tous les noms qu'il fournit ne sont pas disponibles.

Voir aussi _Atomic spécificateur et qualificateur de type .

Table des matières 1 Threads 2 Opérations atomiques 2.1 Opérations sur les types atomiques 2.2 Type flag et opérations 2.3 Initialisation 2.4 Ordre de synchronisation de la mémoire 2.5 Alias de types pratiques 3 Exclusion mutuelle 3.1 Appel unique 4 Variables de condition 5 Stockage local au thread 6 Identifiants réservés 7 Références 8 Voir aussi 9 Liens externes

Fils d'exécution

Défini dans l'en-tête <threads.h>
thrd_t	type d'objet complet défini par l'implémentation identifiant un thread
thrd_create (C11)	crée un thread (fonction)
thrd_equal (C11)	vérifie si deux identifiants font référence au même thread (fonction)
thrd_current (C11)	obtient l'identifiant du thread actuel (fonction)
thrd_sleep (C11)	suspend l'exécution du thread appelant pour la période de temps donnée (fonction)
thrd_yield (C11)	abandonne la tranche de temps actuelle (fonction)
thrd_exit (C11)	termine le thread appelant (fonction)
thrd_detach (C11)	détache un thread (fonction)
thrd_join (C11)	bloque jusqu'à la terminaison d'un thread (fonction)
thrd_success thrd_timedout thrd_busy thrd_nomem thrd_error (C11)	indique un statut d'erreur de thread (constante)
thrd_start_t (C11)	un typedef du type pointeur de fonction int ( * ) ( void * ) , utilisé par thrd_create (typedef)

Opérations atomiques

Défini dans l'en-tête <stdatomic.h>
Opérations sur les types atomiques
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)	indique que le type atomique donné est sans verrou (constante de macro)
atomic_is_lock_free (C11)	indique si l'objet atomique est sans verrou (fonction)
atomic_store atomic_store_explicit (C11)	stocke une valeur dans un objet atomique (fonction)
atomic_load atomic_load_explicit (C11)	lit une valeur depuis un objet atomique (fonction)
atomic_exchange atomic_exchange_explicit (C11)	échange une valeur avec la valeur d'un objet atomique (fonction)
atomic_compare_exchange_strong atomic_compare_exchange_strong_explicit atomic_compare_exchange_weak atomic_compare_exchange_weak_explicit (C11)	échange une valeur avec un objet atomique si l'ancienne valeur correspond à celle attendue, sinon lit l'ancienne valeur (fonction)
atomic_fetch_add atomic_fetch_add_explicit (C11)	addition atomique (fonction)
atomic_fetch_sub atomic_fetch_sub_explicit (C11)	soustraction atomique (fonction)
atomic_fetch_or atomic_fetch_or_explicit (C11)	OU binaire atomique (fonction)
atomic_fetch_xor atomic_fetch_xor_explicit (C11)	OU exclusif atomique au niveau du bit (fonction)
atomic_fetch_and atomic_fetch_and_explicit (C11)	ET atomique bit à bit (fonction)
Type de drapeau et opérations
atomic_flag (C11)	indicateur booléen atomique sans verrouillage (struct)
atomic_flag_test_and_set atomic_flag_test_and_set_explicit (C11)	définit un atomic_flag à true et retourne l'ancienne valeur (fonction)
atomic_flag_clear atomic_flag_clear_explicit (C11)	définit un atomic_flag à false (fonction)
Initialisation
atomic_init (C11)	initialise un objet atomique existant (fonction)
ATOMIC_VAR_INIT (C11) (obsolète en C17) (supprimé en C23)	initialise un nouvel objet atomique (macro de fonction)
ATOMIC_FLAG_INIT (C11)	initialise un nouveau atomic_flag (constante macro)
Ordre de synchronisation de la mémoire
memory_order (C11)	définit les contraintes d'ordonnancement de la mémoire (enum)
kill_dependency (C11)	rompt une chaîne de dépendance pour memory_order_consume (macro fonction)
atomic_thread_fence (C11)	primitive de synchronisation de barrière générique dépendant de l'ordre mémoire (fonction)
atomic_signal_fence (C11)	barrière entre un thread et un gestionnaire de signal exécuté dans le même thread (fonction)

Alias de type de commodité
Nom du typedef	Nom complet du type
atomic_bool (C11)	_Atomic _Bool (jusqu'à C23) _Atomic bool (depuis 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

Exclusion mutuelle

Défini dans l'en-tête <threads.h>
mtx_t	identifiant de mutex
mtx_init (C11)	crée un mutex (fonction)
mtx_lock (C11)	bloque jusqu'à l'obtention du verrou d'un mutex (fonction)
mtx_timedlock (C11)	bloque jusqu'à l'obtention du verrou d'un mutex ou expiration du délai (fonction)
mtx_trylock (C11)	verrouille un mutex ou retourne sans bloquer s'il est déjà verrouillé (fonction)
mtx_unlock (C11)	déverrouille un mutex (fonction)
mtx_destroy (C11)	détruit un mutex (fonction)
mtx_plain mtx_recursive mtx_timed (C11) (C11) (C11)	définit le type d'un mutex (énumération)
Appel unique
call_once (C11)	appelle une fonction exactement une fois (fonction)

Variables de condition

Défini dans l'en-tête <threads.h>
cnd_t	identifiant de variable de condition
cnd_init (C11)	crée une variable de condition (fonction)
cnd_signal (C11)	débloque un thread bloqué sur une variable de condition (fonction)
cnd_broadcast (C11)	débloque tous les threads bloqués sur une variable de condition (fonction)
cnd_wait (C11)	se bloque sur une variable de condition (fonction)
cnd_timedwait (C11)	se bloque sur une variable de condition, avec un délai d'attente (fonction)
cnd_destroy (C11)	détruit une variable de condition (fonction)

Stockage local au thread

Défini dans l'en-tête <threads.h>
thread_local (C11) (supprimé en C23)	macro de commodité pour le spécificateur de classe de stockage _Thread_local (macro mot-clé)
tss_t	pointeur de stockage spécifique au thread
TSS_DTOR_ITERATIONS (C11)	nombre maximum d'appels aux destructeurs (constante macro)
tss_dtor_t (C11)	type de pointeur de fonction void ( * ) ( void * ) , utilisé pour le destructeur TSS (typedef)
tss_create (C11)	crée un pointeur de stockage spécifique au thread avec un destructeur donné (fonction)
tss_get (C11)	lit depuis le stockage spécifique au thread (fonction)
tss_set (C11)	écrit dans le stockage spécifique au thread (fonction)
tss_delete (C11)	libère les ressources détenues par un pointeur spécifique au thread donné (fonction)

Identifiants réservés

Dans les révisions futures de la norme C :

• Les noms de fonctions, noms de types et constantes d'énumération commençant par cnd_ , mtx_ , thrd_ , ou tss_ suivis d'une lettre minuscule peuvent être ajoutés aux déclarations dans l'en-tête <threads.h> ;
• Les macros commençant par ATOMIC_ suivies d'une lettre majuscule peuvent être ajoutées aux macros définies dans l'en-tête <stdatomic.h> ;
• Les noms de types (typedef) commençant par atomic_ ou memory_ suivis d'une lettre minuscule peuvent être ajoutés aux déclarations dans l'en-tête <stdatomic.h> ;
• Les constantes d'énumération commençant par memory_order_ suivies d'une lettre minuscule peuvent être ajoutées à la définition du type memory_order dans l'en-tête <stdatomic.h> ;
• Les noms de fonctions commençant par atomic_ suivis d'une lettre minuscule peuvent être ajoutés aux déclarations dans l'en-tête <stdatomic.h> .

Les identificateurs réservés pour les noms de fonctions sont toujours potentiellement (since C23) réservés pour une utilisation comme identificateurs avec liaison externe, tandis que les autres identificateurs listés ici sont potentiellement (since C23) réservés lorsque <stdatomic.h> est inclus.

Déclarer, définir, ou #undef un tel identifiant entraîne un comportement indéfini s'il est fourni par la norme ou l'implémentation (depuis C23) . Les programmes portables ne devraient pas utiliser ces identifiants.

Références

Voir aussi

Documentation C++ pour Bibliothèque de support de la concurrence

Liens externes

Manuel GNU GCC Libc : Mutexes ISO C