Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

atomic_fetch_or — atomická generická funkce C23

`atomic_fetch_or(object, operand)` z `<stdatomic.h>` atomicky provede `*object |= operand` na atomickém celočíselném typu a vrátí hodnotu před nastavením bitů. Jde o jedinou operaci read-modify-write.

Verze: C23

Syntaxe

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

atomic_fetch_or(object, operand) z <stdatomic.h> atomicky provede *object |= operand na atomickém celočíselném typu a vrátí hodnotu před nastavením bitů. Jde o jedinou operaci read-modify-write.

Hodí se k souběžnému hlášení nezávislých příznaků: bit nastavený jedním vláknem neztratí bity nastavené jinými. Příklad skutečně spojí 0x1 s maskou 0x6, vrátí starou hodnotu 1 a ponechá všechny tři bity jako 7.

Funkce nepodporuje atomické ukazatele; object musí být kompatibilní inicializovaný atomický celočíselný typ. Forma bez _explicit používá memory_order_seq_cst a nemusí být lock-free. OR umí bity nastavit, ne vymazat, a pozorování staré masky samo nepotvrzuje zpracování události jiným vláknem. Podporované atomické celočíselné typy výslovně vylučují _Atomic bool; tato operace nemá ukazatelovou formu.

Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.

Pří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ýsledek

1 7

Hodí se k souběžnému hlášení nezávislých příznaků: bit nastavený jedním vláknem neztratí bity nastavené jinými. Příklad skutečně spojí `0x1` s maskou `0x6`, vrátí starou hodnotu `1` a ponechá všechny tři bity jako `7`.

Zdroje