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`.