KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

<stdatomic.h> — atomaire bewerkingen

De header voor atomaire bewerkingen op gegevens die tussen threads worden gedeeld; biedt vlaggen en macro’s die de lock-free-eigenschap beschrijven.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdatomic.h>
atomic_flag flag = ATOMIC_FLAG_INIT;

<stdatomic.h> biedt atomaire typen en bewerkingen. Een implementatie die __STDC_NO_ATOMICS__ definieert, hoeft deze header niet te bieden.

De macro’s komen overeen met atomaire 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 → pointers. Voor de toepasselijke integer-typen omvatten ze varianten met en zonder teken.

Macrowaarden, bruikbaar in #if: 0 — nooit lock-free, 1 — soms, 2 — altijd. Atomair betekent niet lock-free; ook atomic_is_lock_free kan deze eigenschap opvragen.

ATOMIC_FLAG_INIT initialiseert atomic_flag in de gewiste toestand. Vlagbewerkingen zijn lock-free. Het voorbeeld toont de vorige toestanden die atomic_flag_test_and_set teruggeeft en het resetten met atomic_flag_clear.

Voorbeelden

#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;
}

Resultaat

0 1 0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen