CKTIS / C
atomic_fetch_or — атомарна обобщена функция на C23
`atomic_fetch_or(object, operand)` от `<stdatomic.h>` атомарно изпълнява `*object |= operand` върху атомарен целочислен тип и връща стойността преди задаването на битовете. Това е една операция read-modify-write.
Версия: C23
Синтаксис
C atomic_fetch_or(volatile A *object, M operand);atomic_fetch_or(object, operand) от <stdatomic.h> атомарно изпълнява *object |= operand върху атомарен целочислен тип и връща стойността преди задаването на битовете. Това е една операция read-modify-write.
Подходяща е за конкурентно съобщаване на независими флагове: бит, зададен от една нишка, не губи битове от други. Примерът действително комбинира 0x1 с маска 0x6, връща старото 1 и оставя трите бита като 7.
Функцията не поддържа атомарни указатели; object трябва да е съвместим инициализиран атомарен целочислен тип. Формата без _explicit използва memory_order_seq_cst и не е задължително lock-free. OR може да задава, но не да изчиства битове, а старата маска сама не потвърждава, че друга нишка е обработила събитие. Поддържаните атомарни целочислени типове изрично изключват _Atomic bool; тази операция няма форма за указател.
Името на тази обобщена функция може да е макрос или външен идентификатор; потискането на макроса за извикване на действителна функция или дефинирането на външен идентификатор с това име има неопределено поведение.
Примери
#include <stdatomic.h>
#include <stdio.h>
int main(void) {
atomic_uint flags = 0x1u;
unsigned previous = atomic_fetch_or(&flags, 0x6u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Резултат
1 7
Подходяща е за конкурентно съобщаване на независими флагове: бит, зададен от една нишка, не губи битове от други. Примерът действително комбинира `0x1` с маска `0x6`, връща старото `1` и оставя трите бита като `7`.