WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

atomic_fetch_and — atomare generische C23-Funktion

`atomic_fetch_and(object, operand)` aus `<stdatomic.h>` führt atomar `*object &= operand` auf einem atomaren Ganzzahltyp aus und liefert den Wert vor der Operation. Es ist eine Read-Modify-Write-Operation.

Version: C23

Syntax

C atomic_fetch_and(volatile A *object, M operand);

atomic_fetch_and(object, operand) aus <stdatomic.h> führt atomar *object &= operand auf einem atomaren Ganzzahltyp aus und liefert den Wert vor der Operation. Es ist eine Read-Modify-Write-Operation.

Sie löscht ausgewählte Bits nebenläufig, ohne zwischenzeitlich von anderen Threads gesetzte Flags zu überschreiben. Das Beispiel startet mit 0x7, löscht Bit 0x2 atomar durch ~0x2u, liefert den alten Wert 7 und hinterlässt 5.

Die Funktion akzeptiert keine atomaren Zeiger; object muss auf einen passenden initialisierten atomaren Ganzzahltyp zeigen. Die Form ohne _explicit nutzt memory_order_seq_cst und muss nicht lock-free sein. Die Maske braucht beabsichtigte Breite und Vorzeichenart; eine Maskenoperation bildet keinen Invariant über andere atomare Objekte. Die unterstützten atomaren Ganzzahltypen schließen _Atomic bool ausdrücklich aus; für diese Operation gibt es keine Zeigerform.

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_uint flags = 0x7u;
    unsigned previous = atomic_fetch_and(&flags, ~0x2u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Ergebnis

7 5

Sie löscht ausgewählte Bits nebenläufig, ohne zwischenzeitlich von anderen Threads gesetzte Flags zu überschreiben. Das Beispiel startet mit `0x7`, löscht Bit `0x2` atomar durch `~0x2u`, liefert den alten Wert `7` und hinterlässt `5`.

Quellen