WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen