WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

atomic_init — atomare generische C23-Funktion

`atomic_init(obj, value)` aus `<stdatomic.h>` initialisiert das angegebene atomare Objekt mit `value`, einschließlich zusätzlichem Implementierungszustand, und liefert keinen Wert. Hat der Speicher keinen deklarierten Typ, erhält er durch den Aufruf den effektiven atomaren Typ `A`.

Version: C23

Syntax

void atomic_init(volatile A *obj, C value);

atomic_init(obj, value) aus <stdatomic.h> initialisiert das angegebene atomare Objekt mit value, einschließlich zusätzlichem Implementierungszustand, und liefert keinen Wert. Hat der Speicher keinen deklarierten Typ, erhält er durch den Aufruf den effektiven atomaren Typ A.

Damit wird ein automatisches oder alloziertes atomares Objekt in einen gültigen Zustand gebracht, bevor seine Adresse anderen Threads bekannt gemacht wird. Das Beispiel initialisiert einen atomic_int mit 42 und liest ihn danach tatsächlich mit atomic_load.

atomic_init synchronisiert nicht: Jeder gleichzeitige Zugriff während der Initialisierung, auch ein atomarer, erzeugt ein Datenrennen. Ein nicht atomarer Schreibzugriff auf irgendein Byte, auch durch memcpy oder memset, macht die Darstellung unbestimmt. Ein Aufruf aus einem Signalhandler hat undefiniertes Verhalten, außer das Signal stammt von abort oder raise; statische und threadlokale Objekte außer atomic_flag erhalten durch Standardinitialisierung einen gültigen Zustand.

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_int value;
    atomic_init(&value, 42);
    printf("%d\n", atomic_load(&value));
    return 0;
}

Ergebnis

42

Damit wird ein automatisches oder alloziertes atomares Objekt in einen gültigen Zustand gebracht, bevor seine Adresse anderen Threads bekannt gemacht wird. Das Beispiel initialisiert einen `atomic_int` mit `42` und liest ihn danach tatsächlich mit `atomic_load`.

Quellen