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

CKTIS / C

atomic_fetch_add — atomska generična funkcija C23

`atomic_fetch_add(object, operand)` iz `<stdatomic.h>` atomsko prišteje `operand` atomskemu celoštevilskemu ali kazalčnemu objektu in vrne vrednost pred seštevanjem. To je ena operacija read-modify-write.

Različica: C23

Sintaksa

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

atomic_fetch_add(object, operand) iz <stdatomic.h> atomsko prišteje operand atomskemu celoštevilskemu ali kazalčnemu objektu in vrne vrednost pred seštevanjem. To je ena operacija read-modify-write.

Primerna je za dodeljevanje enoličnih zaporednih števil ali povečevanje skupnega števca brez izgubljenih posodobitev. Primer res prišteje 3 k 10: vrnjena stara vozovnica je 10, stanje po operaciji pa 13.

Oblika brez _explicit uporablja memory_order_seq_cst, vendar ni nujno lock-free. Pri atomskih celih tipih predznačena aritmetika uporablja dvojni komplement brez nedoločenega rezultata preliva; pri atomskem kazalcu je operand ptrdiff_t, rezultat pa je lahko neveljaven naslov. Vedno se vrne stara vrednost. Izraz »atomski celoštevilski tip« izrecno izključuje _Atomic bool; ločeno določena oblika za atomski kazalec ostaja dovoljena.

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_int tickets = 10;
    int previous = atomic_fetch_add(&tickets, 3);
    printf("%d %d\n", previous, atomic_load(&tickets));
    return 0;
}

Rezultat

10 13

Primerna je za dodeljevanje enoličnih zaporednih števil ali povečevanje skupnega števca brez izgubljenih posodobitev. Primer res prišteje `3` k `10`: vrnjena stara vozovnica je `10`, stanje po operaciji pa `13`.

Viri