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

CKTIS / C

atomic_fetch_or — atómová generická funkcia C23

`atomic_fetch_or(object, operand)` z `<stdatomic.h>` atómovo vykoná `*object |= operand` na atómovom celočíselnom type a vráti hodnotu pred nastavením bitov. Ide o jedinú operáciu read-modify-write.

Verzia: C23

Syntax

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

atomic_fetch_or(object, operand) z <stdatomic.h> atómovo vykoná *object |= operand na atómovom celočíselnom type a vráti hodnotu pred nastavením bitov. Ide o jedinú operáciu read-modify-write.

Hodí sa na súbežné hlásenie nezávislých príznakov: bit nastavený jedným vláknom nestratí bity nastavené inými. Príklad skutočne spojí 0x1 s maskou 0x6, vráti starú hodnotu 1 a ponechá všetky tri bity ako 7.

Funkcia nepodporuje atómové ukazovatele; object musí byť kompatibilný inicializovaný atómový celočíselný typ. Forma bez _explicit používa memory_order_seq_cst a nemusí byť lock-free. OR vie bity nastaviť, nie vymazať, a pozorovanie starej masky samo nepotvrdzuje spracovanie udalosti iným vláknom. 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 = 0x1u;
    unsigned previous = atomic_fetch_or(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Výsledok

1 7

Hodí sa na súbežné hlásenie nezávislých príznakov: bit nastavený jedným vláknom nestratí bity nastavené inými. Príklad skutočne spojí `0x1` s maskou `0x6`, vráti starú hodnotu `1` a ponechá všetky tri bity ako `7`.

Zdroje