WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen