CKTIS / C
atomic_fetch_xor — atomická generická funkce C23
`atomic_fetch_xor(object, operand)` z `<stdatomic.h>` atomicky provede `*object ^= operand` na atomickém celočíselném typu a vrátí hodnotu před přepnutím bitů. Jde o jedinou operaci read-modify-write.
Verze: C23
Syntaxe
C atomic_fetch_xor(volatile A *object, M operand);atomic_fetch_xor(object, operand) z <stdatomic.h> atomicky provede *object ^= operand na atomickém celočíselném typu a vrátí hodnotu před přepnutím bitů. Jde o jedinou operaci read-modify-write.
Hodí se k atomickému přepnutí přesně vybraných bitů sdíleného stavu. Příklad skutečně provede XOR 0xA s 0x6: vrátí starou hodnotu 10 a nový vzor 0xC má hodnotu 12.
Funkce nepodporuje atomické ukazatele; forma bez _explicit používá memory_order_seq_cst a nemusí být lock-free. XOR přepíná, nezaznamenává událost: dvě volání se stejnou maskou obnoví předchozí stav a dvě hlášení se mohou zrušit. Maska musí mít zamýšlenou šířku a znaménkovost. Podporované atomické celočíselné typy výslovně vylučují _Atomic bool; tato operace nemá ukazatelovou formu.
Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.
Příklady
#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;
}
Výsledek
10 12
Hodí se k atomickému přepnutí přesně vybraných bitů sdíleného stavu. Příklad skutečně provede XOR `0xA` s `0x6`: vrátí starou hodnotu `10` a nový vzor `0xC` má hodnotu `12`.