CKTIS / C
atomic_fetch_add — atomska generička funkcija C23
`atomic_fetch_add(object, operand)` iz `<stdatomic.h>` atomski dodaje `operand` atomskom cjelobrojnom ili pokazivačkom objektu i vraća vrijednost prije zbrajanja. To je jedna operacija read-modify-write.
Verzija: C23
Sintaksa
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) iz <stdatomic.h> atomski dodaje operand atomskom cjelobrojnom ili pokazivačkom objektu i vraća vrijednost prije zbrajanja. To je jedna operacija read-modify-write.
Služi dodjeljivanju jedinstvenih rednih brojeva ili povećanju zajedničkog brojača bez izgubljenih ažuriranja. Primjer doista dodaje 3 na 10: vraća stari broj 10, a stanje nakon operacije je 13.
Oblik bez _explicit koristi memory_order_seq_cst, ali ne mora biti lock-free. Za atomske cijele tipove predznačena aritmetika koristi dvojni komplement bez nedefiniranog rezultata prekoračenja; za atomski pokazivač operand je ptrdiff_t, a rezultat može biti nevaljana adresa. Uvijek se vraća stara vrijednost. Izraz „atomski cjelobrojni tip” izričito isključuje _Atomic bool; zasebno propisan oblik za atomski pokazivač ostaje dopušten.
Naziv ove generičke funkcije može biti makro ili vanjski identifikator; potiskivanje makroa radi poziva stvarne funkcije ili definiranje vanjskog identifikatora tog naziva ima nedefinirano ponašanje.
Primjeri
#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
Služi dodjeljivanju jedinstvenih rednih brojeva ili povećanju zajedničkog brojača bez izgubljenih ažuriranja. Primjer doista dodaje `3` na `10`: vraća stari broj `10`, a stanje nakon operacije je `13`.