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