База знанияИзпитен център
BGБългарски
Избери език13

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`.

Източници