Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

<stdatomic.h> — operacje atomowe

Nagłówek operacji atomowych dla danych współdzielonych między wątkami; udostępnia flagi i makra określające własność lock-free.

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

Składnia

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

<stdatomic.h> udostępnia typy i operacje atomowe. Implementacja definiująca __STDC_NO_ATOMICS__ nie musi go zapewniać.

Makra odpowiadają typom atomowym: 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 → wskaźniki. Dla odpowiednich typów całkowitych obejmują warianty signed i unsigned.

Wartości makr, dostępne w #if: 0 — nigdy lock-free, 1 — czasami, 2 — zawsze. Atomowość nie oznacza lock-free; służy do tego również zapytanie atomic_is_lock_free.

ATOMIC_FLAG_INIT inicjalizuje atomic_flag w stanie wyczyszczonym. Operacje flagi są lock-free. Przykład pokazuje poprzednie stany zwracane przez atomic_flag_test_and_set oraz reset przez atomic_flag_clear.

Przykłady

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

Wynik

0 1 0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła