CKTIS / C
atomic_fetch_add — atomická generická funkce C23
`atomic_fetch_add(object, operand)` z `<stdatomic.h>` atomicky přičte `operand` k atomickému celočíselnému nebo ukazatelovému objektu a vrátí hodnotu před přičtením. Jde o jedinou operaci read-modify-write.
Verze: C23
Syntaxe
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) z <stdatomic.h> atomicky přičte operand k atomickému celočíselnému nebo ukazatelovému objektu a vrátí hodnotu před přičtením. Jde o jedinou operaci read-modify-write.
Hodí se k přidělování jedinečných pořadových čísel či zvyšování sdíleného čítače bez ztracených aktualizací. Příklad skutečně přičte 3 k 10: vrácený starý lístek je 10 a stav po operaci 13.
Forma bez _explicit používá memory_order_seq_cst, ale nemusí být lock-free. U atomických celých typů používá znaménková aritmetika dvojkový doplněk bez nedefinovaného výsledku přetečení; u atomického ukazatele je operand ptrdiff_t a výsledkem může být neplatná adresa. Vrací se vždy stará hodnota. Pojem „atomický celočíselný typ“ výslovně vylučuje _Atomic bool; samostatně určená forma pro atomický ukazatel zůstává povolena.
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_int tickets = 10;
int previous = atomic_fetch_add(&tickets, 3);
printf("%d %d\n", previous, atomic_load(&tickets));
return 0;
}
Výsledek
10 13
Hodí se k přidělování jedinečných pořadových čísel či zvyšování sdíleného čítače bez ztracených aktualizací. Příklad skutečně přičte `3` k `10`: vrácený starý lístek je `10` a stav po operaci `13`.