CKTIS / C
atomic_fetch_add — atomare generische C23-Funktion
`atomic_fetch_add(object, operand)` aus `<stdatomic.h>` addiert `operand` atomar zu einem atomaren Ganzzahl- oder Zeigerobjekt und liefert den Wert vor der Addition. Es handelt sich um eine Read-Modify-Write-Operation.
Version: C23
Syntax
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) aus <stdatomic.h> addiert operand atomar zu einem atomaren Ganzzahl- oder Zeigerobjekt und liefert den Wert vor der Addition. Es handelt sich um eine Read-Modify-Write-Operation.
Sie eignet sich zur Vergabe eindeutiger Folgenummern oder zum Erhöhen eines gemeinsamen Zählers ohne verlorene Updates. Das Beispiel addiert tatsächlich 3 zu 10: Der zurückgegebene alte Wert ist 10, danach steht der Zähler auf 13.
Die Form ohne _explicit nutzt memory_order_seq_cst, muss aber nicht lock-free sein. Für atomare Ganzzahlen ist vorzeichenbehaftete Arithmetik in Zweierkomplementdarstellung ohne undefiniertes Überlaufergebnis definiert; bei atomaren Zeigern ist der Operand ptrdiff_t und das Ergebnis kann eine ungültige Adresse sein. Zurück kommt stets der alte Wert. Der Ausdruck „atomarer Ganzzahltyp“ schließt _Atomic bool ausdrücklich aus; die separat festgelegte Form für atomare Zeiger bleibt zulässig.
Der Name dieser generischen Funktion darf ein Makro oder ein externer Bezeichner sein; das Unterdrücken des Makros zum Aufruf einer tatsächlichen Funktion oder das Definieren eines externen Bezeichners dieses Namens hat undefiniertes Verhalten.
Beispiele
#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;
}
Ergebnis
10 13
Sie eignet sich zur Vergabe eindeutiger Folgenummern oder zum Erhöhen eines gemeinsamen Zählers ohne verlorene Updates. Das Beispiel addiert tatsächlich `3` zu `10`: Der zurückgegebene alte Wert ist `10`, danach steht der Zähler auf `13`.