CKTIS / C
atomic_fetch_add — atómová generická funkcia C23
`atomic_fetch_add(object, operand)` z `<stdatomic.h>` atómovo pripočíta `operand` k atómovému celočíselnému alebo ukazovateľovému objektu a vráti hodnotu pred pripočítaním. Ide o jedinú operáciu read-modify-write.
Verzia: C23
Syntax
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) z <stdatomic.h> atómovo pripočíta operand k atómovému celočíselnému alebo ukazovateľovému objektu a vráti hodnotu pred pripočítaním. Ide o jedinú operáciu read-modify-write.
Hodí sa na prideľovanie jedinečných poradových čísel či zvyšovanie zdieľaného počítadla bez stratených aktualizácií. Príklad skutočne pripočíta 3 k 10: vrátený starý lístok je 10 a stav po operácii 13.
Forma bez _explicit používa memory_order_seq_cst, ale nemusí byť lock-free. Pri atómových celých typoch používa znamienková aritmetika dvojkový doplnok bez nedefinovaného výsledku pretečenia; pri atómovom ukazovateli je operand ptrdiff_t a výsledkom môže byť neplatná adresa. Vracia sa vždy stará hodnota. Pojem „atómový celočíselný typ“ výslovne vylučuje _Atomic bool; samostatne určená forma pre atómový ukazovateľ zostáva povolená.
Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.
Prí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ýsledok
10 13
Hodí sa na prideľovanie jedinečných poradových čísel či zvyšovanie zdieľaného počítadla bez stratených aktualizácií. Príklad skutočne pripočíta `3` k `10`: vrátený starý lístok je `10` a stav po operácii `13`.