WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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`.

Quellen