CKTIS / C
atomic_fetch_xor — атомарна обобщена функция на C23
`atomic_fetch_xor(object, operand)` от `<stdatomic.h>` атомарно изпълнява `*object ^= operand` върху атомарен целочислен тип и връща стойността преди превключването на битовете. Това е една операция read-modify-write.
Версия: C23
Синтаксис
C atomic_fetch_xor(volatile A *object, M operand);atomic_fetch_xor(object, operand) от <stdatomic.h> атомарно изпълнява *object ^= operand върху атомарен целочислен тип и връща стойността преди превключването на битовете. Това е една операция read-modify-write.
Подходяща е за атомарно превключване на точно избрани битове от споделено състояние. Примерът действително прави XOR на 0xA с 0x6: връща старото 10, а новият шаблон 0xC има стойност 12.
Функцията не поддържа атомарни указатели; формата без _explicit използва memory_order_seq_cst и не е задължително lock-free. XOR превключва, а не записва събитие: две извиквания със същата маска възстановяват предишното състояние и две съобщения могат да се неутрализират. Маската трябва да има желаната ширина и знаковост. Поддържаните атомарни целочислени типове изрично изключват _Atomic bool; тази операция няма форма за указател.
Името на тази обобщена функция може да е макрос или външен идентификатор; потискането на макроса за извикване на действителна функция или дефинирането на външен идентификатор с това име има неопределено поведение.
Примери
#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;
}
Резултат
10 12
Подходяща е за атомарно превключване на точно избрани битове от споделено състояние. Примерът действително прави XOR на `0xA` с `0x6`: връща старото `10`, а новият шаблон `0xC` има стойност `12`.