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

CKTIS / C

atomic_flag_clear — função atómica C23

`atomic_flag_clear(object)` de `<stdatomic.h>` coloca atomicamente o `atomic_flag` apontado no estado limpo e não devolve valor. A forma básica usa `memory_order_seq_cst`.

Versão: C23

Sintaxe

void atomic_flag_clear(volatile atomic_flag *object);

atomic_flag_clear(object) de <stdatomic.h> coloca atomicamente o atomic_flag apontado no estado limpo e não devolve valor. A forma básica usa memory_order_seq_cst.

Serve para libertar uma flag de posse após a secção protegida. O exemplo define realmente a flag, limpa-a e depois atomic_flag_test_and_set devolve 0, provando que o estado anterior estava limpo.

A flag tem de estar corretamente inicializada, por exemplo com ATOMIC_FLAG_INIT, e o ponteiro válido. Limpar um bloqueio por uma thread que não o possui viola o protocolo apesar da atomicidade. atomic_flag_clear_explicit não pode usar memory_order_acquire nem memory_order_acq_rel; release é típico ao libertar spinlock.

Exemplos

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_flag flag = ATOMIC_FLAG_INIT;
    (void)atomic_flag_test_and_set(&flag);
    atomic_flag_clear(&flag);
    printf("%d\n", atomic_flag_test_and_set(&flag));
    return 0;
}

Resultado

0

Serve para libertar uma flag de posse após a secção protegida. O exemplo define realmente a flag, limpa-a e depois `atomic_flag_test_and_set` devolve `0`, provando que o estado anterior estava limpo.

Fontes