Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_flag_test_and_set — funzione atomica C23

`atomic_flag_test_and_set(object)` di `<stdatomic.h>` imposta atomicamente un `atomic_flag` e restituisce lo stato precedente: `false` indica l’acquisizione di un flag prima libero, `true` che era già impostato.

Versione: C23

Sintassi

bool atomic_flag_test_and_set(volatile atomic_flag *object);

atomic_flag_test_and_set(object) di <stdatomic.h> imposta atomicamente un atomic_flag e restituisce lo stato precedente: false indica l’acquisizione di un flag prima libero, true che era già impostato.

È la primitiva base per tentare l’acquisizione di un semplice lock. L’esempio la chiama davvero due volte su un flag inizializzato con ATOMIC_FLAG_INIT: la prima restituisce 0, la seconda 1, perché il flag resta impostato.

atomic_flag è garantito lock-free, ma l’attesa attiva può affamare thread, consumare CPU e bloccarsi se lo stesso thread riacquisisce. La forma senza _explicit usa memory_order_seq_cst; uno spinlock tipico usa acquire al successo e release in atomic_flag_clear_explicit. Il flag deve essere inizializzato e poi cancellato esplicitamente.

Esempi

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

Risultato

0 1

È la primitiva base per tentare l’acquisizione di un semplice lock. L’esempio la chiama davvero due volte su un flag inizializzato con `ATOMIC_FLAG_INIT`: la prima restituisce `0`, la seconda `1`, perché il flag resta impostato.

Fonti