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