CKTIS / C
atomic_fetch_xor — funzione generica atomica C23
`atomic_fetch_xor(object, operand)` di `<stdatomic.h>` esegue atomicamente `*object ^= operand` su un tipo intero atomico e restituisce il valore precedente al toggle dei bit. È un’unica operazione read-modify-write.
Versione: C23
Sintassi
C atomic_fetch_xor(volatile A *object, M operand);atomic_fetch_xor(object, operand) di <stdatomic.h> esegue atomicamente *object ^= operand su un tipo intero atomico e restituisce il valore precedente al toggle dei bit. È un’unica operazione read-modify-write.
Serve a commutare atomicamente bit selezionati dello stato condiviso. L’esempio applica davvero XOR tra 0xA e 0x6: restituisce il vecchio 10 e il nuovo pattern 0xC vale 12.
Non supporta puntatori atomici; la forma senza _explicit usa memory_order_seq_cst e può non essere lock-free. XOR commuta, non registra un evento: due chiamate con la stessa maschera ripristinano lo stato precedente e due segnalazioni possono annullarsi. La maschera deve avere larghezza e segno voluti. 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 = 0xAu;
unsigned previous = atomic_fetch_xor(&flags, 0x6u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Risultato
10 12
Serve a commutare atomicamente bit selezionati dello stato condiviso. L’esempio applica davvero XOR tra `0xA` e `0x6`: restituisce il vecchio `10` e il nuovo pattern `0xC` vale `12`.