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.