Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje