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

CKTIS / C

atomic_fetch_and — атомарна обобщена функция на C23

`atomic_fetch_and(object, operand)` от `<stdatomic.h>` атомарно изпълнява `*object &= operand` върху атомарен целочислен тип и връща стойността преди операцията. Това е една операция read-modify-write.

Версия: C23

Синтаксис

C atomic_fetch_and(volatile A *object, M operand);

atomic_fetch_and(object, operand) от <stdatomic.h> атомарно изпълнява *object &= operand върху атомарен целочислен тип и връща стойността преди операцията. Това е една операция read-modify-write.

Подходяща е за конкурентно изчистване на избрани битове без презаписване на флагове, зададени междувременно от други нишки. Примерът започва с 0x7, атомарно изчиства бит 0x2 чрез ~0x2u, връща старото 7 и оставя 5.

Функцията не приема атомарни указатели; object трябва да сочи съвместим инициализиран атомарен целочислен тип. Формата без _explicit използва memory_order_seq_cst и не е задължително lock-free. Маската трябва да има желаната ширина и знаковост; една операция не създава инвариант върху други атомарни обекти. Поддържаните атомарни целочислени типове изрично изключват _Atomic bool; тази операция няма форма за указател.

Името на тази обобщена функция може да е макрос или външен идентификатор; потискането на макроса за извикване на действителна функция или дефинирането на външен идентификатор с това име има неопределено поведение.

Примери

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_uint flags = 0x7u;
    unsigned previous = atomic_fetch_and(&flags, ~0x2u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Резултат

7 5

Подходяща е за конкурентно изчистване на избрани битове без презаписване на флагове, зададени междувременно от други нишки. Примерът започва с `0x7`, атомарно изчиства бит `0x2` чрез `~0x2u`, връща старото `7` и оставя `5`.

Източници