CKTIS / C
atomic_fetch_xor — atómová generická funkcia C23
`atomic_fetch_xor(object, operand)` z `<stdatomic.h>` atómovo vykoná `*object ^= operand` na atómovom celočíselnom type a vráti hodnotu pred prepnutím bitov. Ide o jedinú operáciu read-modify-write.
Verzia: C23
Syntax
C atomic_fetch_xor(volatile A *object, M operand);atomic_fetch_xor(object, operand) z <stdatomic.h> atómovo vykoná *object ^= operand na atómovom celočíselnom type a vráti hodnotu pred prepnutím bitov. Ide o jedinú operáciu read-modify-write.
Hodí sa na atómové prepnutie presne vybraných bitov zdieľaného stavu. Príklad skutočne vykoná XOR 0xA s 0x6: vráti starú hodnotu 10 a nový vzor 0xC má hodnotu 12.
Funkcia nepodporuje atómové ukazovatele; forma bez _explicit používa memory_order_seq_cst a nemusí byť lock-free. XOR prepína, nezaznamenáva udalosť: dve volania s rovnakou maskou obnovia predchádzajúci stav a dve hlásenia sa môžu zrušiť. Maska musí mať zamýšľanú šírku a znamienkovosť. Podporované atómové celočíselné typy výslovne vylučujú _Atomic bool; táto operácia nemá ukazovateľovú formu.
Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.
Prí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ýsledok
10 12
Hodí sa na atómové prepnutie presne vybraných bitov zdieľaného stavu. Príklad skutočne vykoná XOR `0xA` s `0x6`: vráti starú hodnotu `10` a nový vzor `0xC` má hodnotu `12`.