База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

<stdatomic.h> — атомарни операции

Заглавният файл за атомарни операции с данни, споделяни между нишки; предоставя флагове и макроси, описващи свойството lock-free.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

<stdatomic.h> предоставя атомарни типове и операции. Реализация, която дефинира __STDC_NO_ATOMICS__, не е длъжна да го предоставя.

Макросите съответстват на атомарни типове: 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 → указатели. За съответните целочислени типове те обхващат вариантите със и без знак.

Стойности на макросите, които могат да се използват в #if: 0 — никога lock-free, 1 — понякога, 2 — винаги. Атомарно не означава lock-free; това свойство може да се провери и с atomic_is_lock_free.

ATOMIC_FLAG_INIT инициализира atomic_flag в изчистено състояние. Операциите с флагове са lock-free. Примерът показва предишните състояния, върнати от atomic_flag_test_and_set, и нулирането чрез atomic_flag_clear.

Примери

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

Резултат

0 1 0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници