Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_flag_clear — funkcja atomowa C23

`atomic_flag_clear(object)` z `<stdatomic.h>` atomowo ustawia wskazany `atomic_flag` w stanie wyczyszczonym i nie zwraca wartości. Wariant podstawowy wykonuje operację z porządkiem `memory_order_seq_cst`.

Wersja: C23

Składnia

void atomic_flag_clear(volatile atomic_flag *object);

atomic_flag_clear(object) z <stdatomic.h> atomowo ustawia wskazany atomic_flag w stanie wyczyszczonym i nie zwraca wartości. Wariant podstawowy wykonuje operację z porządkiem memory_order_seq_cst.

Służy do zwolnienia flagi zajętości po zakończeniu chronionej sekcji. Przykład naprawdę ustawia flagę, czyści ją, a następne atomic_flag_test_and_set zwraca 0, dowodząc że poprzedni stan był wyczyszczony.

Flaga musi być poprawnie zainicjalizowana, na przykład przez ATOMIC_FLAG_INIT, a wskaźnik musi być ważny. Wyczyszczenie blokady przez wątek, który jej nie posiada, łamie protokół mimo atomowości. W atomic_flag_clear_explicit nie wolno użyć memory_order_acquire ani memory_order_acq_rel; dla zwolnienia spinlocka typowy jest porządek release.

Przykłady

#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;
}

Wynik

0

Służy do zwolnienia flagi zajętości po zakończeniu chronionej sekcji. Przykład naprawdę ustawia flagę, czyści ją, a następne `atomic_flag_test_and_set` zwraca `0`, dowodząc że poprzedni stan był wyczyszczony.

Źródła