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

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

Източници