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

CKTIS / C

atomic_flag_test_and_set — função atómica C23

`atomic_flag_test_and_set(object)` de `<stdatomic.h>` define atomicamente um `atomic_flag` e devolve o estado anterior: `false` significa aquisição de uma flag antes limpa e `true` que já estava definida.

Versão: C23

Sintaxe

bool atomic_flag_test_and_set(volatile atomic_flag *object);

atomic_flag_test_and_set(object) de <stdatomic.h> define atomicamente um atomic_flag e devolve o estado anterior: false significa aquisição de uma flag antes limpa e true que já estava definida.

É a primitiva básica para tentar adquirir um bloqueio simples. O exemplo chama-a realmente duas vezes numa flag inicializada com ATOMIC_FLAG_INIT: a primeira devolve 0, a segunda 1, pois a flag continua definida.

atomic_flag é garantidamente lock-free, mas espera ativa pode causar fome, consumir CPU e bloquear se a mesma thread readquirir. A forma sem _explicit usa memory_order_seq_cst; um spinlock típico usa acquire na aquisição e release em atomic_flag_clear_explicit. A flag tem de ser inicializada e depois limpa explicitamente.

Exemplos

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

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

Resultado

0 1

É a primitiva básica para tentar adquirir um bloqueio simples. O exemplo chama-a realmente duas vezes numa flag inicializada com `ATOMIC_FLAG_INIT`: a primeira devolve `0`, a segunda `1`, pois a flag continua definida.

Fontes