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

CKTIS / C

atomic_fetch_and — atomická generická funkce C23

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

Verze: C23

Syntaxe

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

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

Hodí se k souběžnému vymazání vybraných bitů bez přepsání příznaků mezitím nastavených jinými vlákny. Příklad začne maskou 0x7, atomicky vymaže bit 0x2 přes ~0x2u, vrátí starou hodnotu 7 a zanechá 5.

Funkce nepřijímá atomické ukazatele; object musí ukazovat na kompatibilní inicializovaný atomický celočíselný typ. Forma bez _explicit používá memory_order_seq_cst a nemusí být lock-free. Maska musí mít zamýšlenou šířku a znaménkovost; jedna operace nevytvoří invariant přes další atomické objekty. 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 = 0x7u;
    unsigned previous = atomic_fetch_and(&flags, ~0x2u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Výsledek

7 5

Hodí se k souběžnému vymazání vybraných bitů bez přepsání příznaků mezitím nastavených jinými vlákny. Příklad začne maskou `0x7`, atomicky vymaže bit `0x2` přes `~0x2u`, vrátí starou hodnotu `7` a zanechá `5`.

Zdroje