WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

atomic_fetch_xor — atomare generische C23-Funktion

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

Version: C23

Syntax

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

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

Sie schaltet genau ausgewählte Bits eines gemeinsamen Zustands atomar um. Das Beispiel XOR-verknüpft tatsächlich 0xA mit 0x6: Es liefert den alten Wert 10, das neue Muster 0xC hat den Wert 12.

Die Funktion unterstützt keine atomaren Zeiger; die Form ohne _explicit nutzt memory_order_seq_cst und muss nicht lock-free sein. XOR schaltet um, statt ein Ereignis zu speichern: Zwei Aufrufe mit derselben Maske stellen den vorherigen Zustand wieder her, sodass sich zwei Meldungen aufheben können. Die Maske braucht passende Breite und Vorzeichenart. 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 = 0xAu;
    unsigned previous = atomic_fetch_xor(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Ergebnis

10 12

Sie schaltet genau ausgewählte Bits eines gemeinsamen Zustands atomar um. Das Beispiel XOR-verknüpft tatsächlich `0xA` mit `0x6`: Es liefert den alten Wert `10`, das neue Muster `0xC` hat den Wert `12`.

Quellen