WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen