CKTIS / C
atomic_fetch_sub — atomare generische C23-Funktion
`atomic_fetch_sub(object, operand)` aus `<stdatomic.h>` subtrahiert `operand` atomar von einem atomaren Ganzzahl- oder Zeigerobjekt und liefert den Wert vor der Subtraktion. Es ist eine Read-Modify-Write-Operation.
Version: C23
Syntax
C atomic_fetch_sub(volatile A *object, M operand);atomic_fetch_sub(object, operand) aus <stdatomic.h> subtrahiert operand atomar von einem atomaren Ganzzahl- oder Zeigerobjekt und liefert den Wert vor der Subtraktion. Es ist eine Read-Modify-Write-Operation.
Sie verringert einen gemeinsamen Zähler ohne verlorene Updates, wenn der alte Wert für eine Entscheidung benötigt wird. Das Beispiel subtrahiert tatsächlich 6 von 20: Es liefert den früheren Wert 20, danach beträgt der Zustand 14.
Die Form ohne _explicit nutzt memory_order_seq_cst und muss nicht lock-free sein. Sie sättigt nicht bei null: vorzeichenbehaftete atomare Ganzzahlarithmetik nutzt Zweierkomplement ohne undefinierten Überlauf, vorzeichenlose wickelt modulo; bei atomaren Zeigern ist der Operand ptrdiff_t und das Ergebnis kann eine ungültige Adresse sein. 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 remaining = 20;
int previous = atomic_fetch_sub(&remaining, 6);
printf("%d %d\n", previous, atomic_load(&remaining));
return 0;
}
Ergebnis
20 14
Sie verringert einen gemeinsamen Zähler ohne verlorene Updates, wenn der alte Wert für eine Entscheidung benötigt wird. Das Beispiel subtrahiert tatsächlich `6` von `20`: Es liefert den früheren Wert `20`, danach beträgt der Zustand `14`.