CKTIS / C
atomic_flag_clear — atomare C23-Funktion
`atomic_flag_clear(object)` aus `<stdatomic.h>` versetzt den angegebenen `atomic_flag` atomar in den gelöschten Zustand und liefert keinen Wert. Die Grundform nutzt `memory_order_seq_cst`.
Version: C23
Syntax
void atomic_flag_clear(volatile atomic_flag *object);atomic_flag_clear(object) aus <stdatomic.h> versetzt den angegebenen atomic_flag atomar in den gelöschten Zustand und liefert keinen Wert. Die Grundform nutzt memory_order_seq_cst.
Sie gibt ein Besitz-Flag nach Abschluss des geschützten Abschnitts frei. Das Beispiel setzt das Flag wirklich, löscht es und erhält danach von atomic_flag_test_and_set den Wert 0, womit der vorherige Zustand als gelöscht nachgewiesen ist.
Das Flag muss korrekt, etwa mit ATOMIC_FLAG_INIT, initialisiert und der Zeiger gültig sein. Löschen einer Sperre durch einen Thread ohne Besitz verletzt trotz Atomarität das Protokoll. atomic_flag_clear_explicit darf weder memory_order_acquire noch memory_order_acq_rel verwenden; für Spinlock-Unlock ist release typisch.
Beispiele
#include <stdatomic.h>
#include <stdio.h>
int main(void) {
atomic_flag flag = ATOMIC_FLAG_INIT;
(void)atomic_flag_test_and_set(&flag);
atomic_flag_clear(&flag);
printf("%d\n", atomic_flag_test_and_set(&flag));
return 0;
}
Ergebnis
0
Sie gibt ein Besitz-Flag nach Abschluss des geschützten Abschnitts frei. Das Beispiel setzt das Flag wirklich, löscht es und erhält danach von `atomic_flag_test_and_set` den Wert `0`, womit der vorherige Zustand als gelöscht nachgewiesen ist.