WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen