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`.