CKTIS / C
<stdatomic.h> — opérations atomiques
L’en-tête consacré aux opérations atomiques sur les données partagées entre threads ; il fournit des indicateurs et des macros qui décrivent la propriété lock-free.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdatomic.h>
atomic_flag flag = ATOMIC_FLAG_INIT;<stdatomic.h> fournit des types et des opérations atomiques. Une implémentation qui définit __STDC_NO_ATOMICS__ n’est pas tenue de le fournir.
Les macros correspondent aux types atomiques : ATOMIC_BOOL_LOCK_FREE → bool ; ATOMIC_CHAR_LOCK_FREE → char ; ATOMIC_CHAR16_T_LOCK_FREE → char16_t ; ATOMIC_CHAR32_T_LOCK_FREE → char32_t ; ATOMIC_WCHAR_T_LOCK_FREE → wchar_t ; ATOMIC_SHORT_LOCK_FREE → short ; ATOMIC_INT_LOCK_FREE → int ; ATOMIC_LONG_LOCK_FREE → long ; ATOMIC_LLONG_LOCK_FREE → long long ; ATOMIC_POINTER_LOCK_FREE → les pointeurs. Pour les types entiers concernés, elles couvrent les variantes signées et non signées.
Valeurs des macros, utilisables dans #if : 0 — jamais lock-free, 1 — parfois, 2 — toujours. Atomique ne signifie pas lock-free ; atomic_is_lock_free permet également d’interroger cette propriété.
ATOMIC_FLAG_INIT initialise atomic_flag à l’état effacé. Les opérations sur les indicateurs sont lock-free. L’exemple montre les états précédents renvoyés par atomic_flag_test_and_set et la réinitialisation avec atomic_flag_clear.
Exemples
#include <stdatomic.h>
#include <stdio.h>
int main(void)
{
atomic_flag flag = ATOMIC_FLAG_INIT;
int first = atomic_flag_test_and_set(&flag);
int second = atomic_flag_test_and_set(&flag);
atomic_flag_clear(&flag);
int third = atomic_flag_test_and_set(&flag);
printf("%d %d %d\n", first, second, third);
return 0;
}
Résultat
0 1 0
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.