CKTIS / C
atomic_fetch_xor — función genérica atómica de C23
`atomic_fetch_xor(object, operand)` de `<stdatomic.h>` realiza atómicamente `*object ^= operand` sobre un tipo entero atómico y devuelve el valor anterior a invertir los bits. Es una única operación read-modify-write.
Versión: C23
Sintaxis
C atomic_fetch_xor(volatile A *object, M operand);atomic_fetch_xor(object, operand) de <stdatomic.h> realiza atómicamente *object ^= operand sobre un tipo entero atómico y devuelve el valor anterior a invertir los bits. Es una única operación read-modify-write.
Sirve para invertir atómicamente bits seleccionados del estado compartido. El ejemplo aplica realmente XOR entre 0xA y 0x6: devuelve el antiguo 10 y el nuevo patrón 0xC vale 12.
No admite punteros atómicos; la forma sin _explicit usa memory_order_seq_cst y no tiene que ser lock-free. XOR invierte, no registra un evento: dos llamadas con la misma máscara restauran el estado anterior y dos avisos pueden cancelarse. La máscara debe tener ancho y signo previstos. Los tipos enteros atómicos admitidos excluyen explícitamente _Atomic bool; esta operación no tiene forma para punteros.
El nombre de esta función genérica puede ser una macro o un identificador externo; suprimir la macro para llamar a una función real o definir un identificador externo con ese nombre tiene comportamiento indefinido.
Ejemplos
#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;
}
Resultado
10 12
Sirve para invertir atómicamente bits seleccionados del estado compartido. El ejemplo aplica realmente XOR entre `0xA` y `0x6`: devuelve el antiguo `10` y el nuevo patrón `0xC` vale `12`.