Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

atomic_fetch_and — atomska generična funkcija C23

`atomic_fetch_and(object, operand)` iz `<stdatomic.h>` atomsko izvede `*object &= operand` na atomskem celoštevilskem tipu in vrne vrednost pred operacijo. To je ena operacija read-modify-write.

Različica: C23

Sintaksa

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

atomic_fetch_and(object, operand) iz <stdatomic.h> atomsko izvede *object &= operand na atomskem celoštevilskem tipu in vrne vrednost pred operacijo. To je ena operacija read-modify-write.

Primerna je za sočasno brisanje izbranih bitov brez prepisovanja zastavic, ki so jih medtem nastavile druge niti. Primer začne z 0x7, atomsko izbriše bit 0x2 prek ~0x2u, vrne staro 7 in pusti 5.

Funkcija ne sprejme atomskih kazalcev; object mora kazati na združljiv inicializiran atomski celoštevilski tip. Oblika brez _explicit uporablja memory_order_seq_cst in ni nujno lock-free. Maska mora imeti želeno širino in predznačenost; ena operacija ne ustvari invariante čez druge atomske objekte. Podprti atomski celoštevilski tipi izrecno izključujejo _Atomic bool; ta operacija nima kazalčne oblike.

Ime te generične funkcije je lahko makro ali zunanji identifikator; zatiranje makra za klic dejanske funkcije ali definiranje zunanjega identifikatorja s tem imenom ima nedoločeno vedenje.

Primeri

#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;
}

Rezultat

7 5

Primerna je za sočasno brisanje izbranih bitov brez prepisovanja zastavic, ki so jih medtem nastavile druge niti. Primer začne z `0x7`, atomsko izbriše bit `0x2` prek `~0x2u`, vrne staro `7` in pusti `5`.

Viri