CKTIS / C
<stdatomic.h> — atomare Operationen
Der Header für atomare Operationen auf Daten, die zwischen Threads geteilt werden; er stellt Flags und Makros bereit, die die Lock-free-Eigenschaft beschreiben.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdatomic.h>
atomic_flag flag = ATOMIC_FLAG_INIT;<stdatomic.h> stellt atomare Typen und Operationen bereit. Eine Implementierung, die __STDC_NO_ATOMICS__ definiert, muss den Header nicht bereitstellen.
Die Makros entsprechen atomaren Typen: 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 → Zeiger. Für die entsprechenden Ganzzahltypen decken sie vorzeichenbehaftete und vorzeichenlose Varianten ab.
Makrowerte, die in #if verwendet werden können: 0 — niemals lock-free, 1 — manchmal, 2 — immer. Atomar bedeutet nicht lock-free; auch atomic_is_lock_free fragt diese Eigenschaft ab.
ATOMIC_FLAG_INIT initialisiert atomic_flag im gelöschten Zustand. Flag-Operationen sind lock-free. Das Beispiel zeigt die vorherigen Zustände, die atomic_flag_test_and_set zurückgibt, und das Zurücksetzen mit atomic_flag_clear.
Beispiele
#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;
}
Ergebnis
0 1 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.