CKTIS / C
atomic_fetch_add — атомарна обобщена функция на C23
`atomic_fetch_add(object, operand)` от `<stdatomic.h>` атомарно добавя `operand` към атомарен целочислен обект или указател и връща стойността преди събирането. Това е една операция read-modify-write.
Версия: C23
Синтаксис
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) от <stdatomic.h> атомарно добавя operand към атомарен целочислен обект или указател и връща стойността преди събирането. Това е една операция read-modify-write.
Подходяща е за раздаване на уникални поредни номера или увеличаване на споделен брояч без загубени обновявания. Примерът действително добавя 3 към 10: връща стария билет 10, а състоянието след операцията е 13.
Формата без _explicit използва memory_order_seq_cst, но не е задължително lock-free. За атомарни цели типове знаковата аритметика използва допълнение до две без неопределен резултат от препълване; за атомарен указател операндът е ptrdiff_t, а резултатът може да е невалиден адрес. Винаги се връща старата стойност. Изразът „атомен целочислен тип“ изрично изключва _Atomic bool; отделно специфицираната форма за атомарен указател остава разрешена.
Името на тази обобщена функция може да е макрос или външен идентификатор; потискането на макроса за извикване на действителна функция или дефинирането на външен идентификатор с това име има неопределено поведение.
Примери
#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;
}
Резултат
10 13
Подходяща е за раздаване на уникални поредни номера или увеличаване на споделен брояч без загубени обновявания. Примерът действително добавя `3` към `10`: връща стария билет `10`, а състоянието след операцията е `13`.