CKTIS / C
atomic_fetch_or — atomare generische C23-Funktion
`atomic_fetch_or(object, operand)` aus `<stdatomic.h>` führt atomar `*object |= operand` auf einem atomaren Ganzzahltyp aus und liefert den Wert vor dem Setzen der Bits. Es ist eine Read-Modify-Write-Operation.
Version: C23
Syntax
C atomic_fetch_or(volatile A *object, M operand);atomic_fetch_or(object, operand) aus <stdatomic.h> führt atomar *object |= operand auf einem atomaren Ganzzahltyp aus und liefert den Wert vor dem Setzen der Bits. Es ist eine Read-Modify-Write-Operation.
Sie eignet sich zum nebenläufigen Melden unabhängiger Flags: Ein von einem Thread gesetztes Bit verliert keine von anderen gesetzten Bits. Das Beispiel verbindet tatsächlich 0x1 mit Maske 0x6, liefert den alten Wert 1 und hinterlässt alle drei Bits als 7.
Die Funktion unterstützt keine atomaren Zeiger; object muss ein passender initialisierter atomarer Ganzzahltyp sein. Die Form ohne _explicit nutzt memory_order_seq_cst und muss nicht lock-free sein. OR setzt Bits, löscht sie aber nicht; die alte Maske ist nicht automatisch eine Bestätigung, dass ein anderer Thread ein Ereignis bearbeitet hat. 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 = 0x1u;
unsigned previous = atomic_fetch_or(&flags, 0x6u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Ergebnis
1 7
Sie eignet sich zum nebenläufigen Melden unabhängiger Flags: Ein von einem Thread gesetztes Bit verliert keine von anderen gesetzten Bits. Das Beispiel verbindet tatsächlich `0x1` mit Maske `0x6`, liefert den alten Wert `1` und hinterlässt alle drei Bits als `7`.