Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_fetch_and — funzione generica atomica C23

`atomic_fetch_and(object, operand)` di `<stdatomic.h>` esegue atomicamente `*object &= operand` su un tipo intero atomico e restituisce il valore precedente. È un’unica operazione read-modify-write.

Versione: C23

Sintassi

C atomic_fetch_and(volatile A *object, M operand);

atomic_fetch_and(object, operand) di <stdatomic.h> esegue atomicamente *object &= operand su un tipo intero atomico e restituisce il valore precedente. È un’unica operazione read-modify-write.

Serve a cancellare bit selezionati in concorrenza senza sovrascrivere flag impostati nel frattempo da altri thread. L’esempio parte da 0x7, cancella atomicamente il bit 0x2 tramite ~0x2u, restituisce il vecchio 7 e lascia 5.

Non accetta puntatori atomici; object deve puntare a un intero atomico compatibile e inizializzato. La forma senza _explicit usa memory_order_seq_cst e può non essere lock-free. La maschera deve avere larghezza e segno voluti; una singola maschera non crea un invariante che coinvolga altri oggetti atomici. I tipi interi atomici supportati escludono esplicitamente _Atomic bool; questa operazione non ha una forma per puntatori.

Il nome di questa funzione generica può essere una macro o un identificatore esterno; sopprimere la macro per chiamare una funzione reale o definire un identificatore esterno con quel nome ha comportamento indefinito.

Esempi

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

int main(void) {
    atomic_uint flags = 0x7u;
    unsigned previous = atomic_fetch_and(&flags, ~0x2u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Risultato

7 5

Serve a cancellare bit selezionati in concorrenza senza sovrascrivere flag impostati nel frattempo da altri thread. L’esempio parte da `0x7`, cancella atomicamente il bit `0x2` tramite `~0x2u`, restituisce il vecchio `7` e lascia `5`.

Fonti