Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

<stdatomic.h> — operações atómicas

O cabeçalho para operações atómicas sobre dados partilhados entre threads; disponibiliza sinalizadores e macros que descrevem a propriedade lock-free.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

<stdatomic.h> disponibiliza tipos e operações atómicas. Uma implementação que defina __STDC_NO_ATOMICS__ não tem de o disponibilizar.

As macros correspondem a tipos atómicos: 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 → ponteiros. Para os tipos inteiros aplicáveis, abrangem as variantes com e sem sinal.

Valores das macros, utilizáveis em #if: 0 — nunca lock-free, 1 — por vezes, 2 — sempre. Ser atómico não significa ser lock-free; atomic_is_lock_free também permite consultar esta propriedade.

ATOMIC_FLAG_INIT inicializa atomic_flag no estado limpo. As operações sobre sinalizadores são lock-free. O exemplo mostra os estados anteriores devolvidos por atomic_flag_test_and_set e a reposição através de atomic_flag_clear.

Exemplos

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

Resultado

0 1 0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes