CKTIS / C
atomic_fetch_and — atómová generická funkcia C23
`atomic_fetch_and(object, operand)` z `<stdatomic.h>` atómovo vykoná `*object &= operand` na atómovom celočíselnom type a vráti hodnotu pred operáciou. Ide o jedinú operáciu read-modify-write.
Verzia: C23
Syntax
C atomic_fetch_and(volatile A *object, M operand);atomic_fetch_and(object, operand) z <stdatomic.h> atómovo vykoná *object &= operand na atómovom celočíselnom type a vráti hodnotu pred operáciou. Ide o jedinú operáciu read-modify-write.
Hodí sa na súbežné vymazanie vybraných bitov bez prepísania príznakov medzitým nastavených inými vláknami. Príklad začne maskou 0x7, atómovo vymaže bit 0x2 cez ~0x2u, vráti starú hodnotu 7 a ponechá 5.
Funkcia neprijíma atómové ukazovatele; object musí ukazovať na kompatibilný inicializovaný atómový celočíselný typ. Forma bez _explicit používa memory_order_seq_cst a nemusí byť lock-free. Maska musí mať zamýšľanú šírku a znamienkovosť; jedna operácia nevytvorí invariant cez ďalšie atómové objekty. Podporované atómové celočíselné typy výslovne vylučujú _Atomic bool; táto operácia nemá ukazovateľovú formu.
Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.
Príklady
#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;
}
Výsledok
7 5
Hodí sa na súbežné vymazanie vybraných bitov bez prepísania príznakov medzitým nastavených inými vláknami. Príklad začne maskou `0x7`, atómovo vymaže bit `0x2` cez `~0x2u`, vráti starú hodnotu `7` a ponechá `5`.