CKTIS / C
atomic_flag_clear — fonction atomique C23
`atomic_flag_clear(object)` de `<stdatomic.h>` place atomiquement l’`atomic_flag` pointé dans l’état effacé et ne renvoie aucune valeur. La forme de base utilise `memory_order_seq_cst`.
Version : C23
Syntaxe
void atomic_flag_clear(volatile atomic_flag *object);atomic_flag_clear(object) de <stdatomic.h> place atomiquement l’atomic_flag pointé dans l’état effacé et ne renvoie aucune valeur. La forme de base utilise memory_order_seq_cst.
Elle sert à libérer un indicateur de possession après la section protégée. L’exemple pose réellement le drapeau, l’efface, puis atomic_flag_test_and_set renvoie 0, prouvant que l’état précédent était effacé.
Le drapeau doit être correctement initialisé, par exemple avec ATOMIC_FLAG_INIT, et le pointeur valide. Effacer un verrou depuis un thread non propriétaire viole le protocole malgré l’atomicité. atomic_flag_clear_explicit ne doit employer ni memory_order_acquire ni memory_order_acq_rel ; release est usuel pour libérer un spinlock.
Exemples
#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;
}
Résultat
0
Elle sert à libérer un indicateur de possession après la section protégée. L’exemple pose réellement le drapeau, l’efface, puis `atomic_flag_test_and_set` renvoie `0`, prouvant que l’état précédent était effacé.