Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

<stdatomic.h> — atomické operace

Hlavička pro atomické operace s daty sdílenými mezi vlákny; poskytuje příznaky a makra popisující vlastnost lock-free.

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

Syntaxe

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

<stdatomic.h> poskytuje atomické typy a operace. Implementace, která definuje __STDC_NO_ATOMICS__, ji nemusí poskytovat.

Makra odpovídají atomickým typům: 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 → ukazatele. U příslušných celočíselných typů pokrývají varianty se znaménkem i bez znaménka.

Hodnoty maker, použitelné v #if: 0 — nikdy lock-free, 1 — někdy, 2 — vždy. Atomické neznamená lock-free; tuto vlastnost lze také zjistit pomocí atomic_is_lock_free.

ATOMIC_FLAG_INIT inicializuje atomic_flag do vymazaného stavu. Operace s příznaky jsou lock-free. Příklad ukazuje předchozí stavy vrácené funkcí atomic_flag_test_and_set a resetování pomocí atomic_flag_clear.

Příklady

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

Výsledek

0 1 0

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje