Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

atomic_flag_test_and_set — fonction atomique C23

`atomic_flag_test_and_set(object)` de `<stdatomic.h>` pose atomiquement un `atomic_flag` et renvoie son état précédent : `false` signifie acquisition d’un drapeau auparavant effacé, `true` qu’il était déjà posé.

Version : C23

Syntaxe

bool atomic_flag_test_and_set(volatile atomic_flag *object);

atomic_flag_test_and_set(object) de <stdatomic.h> pose atomiquement un atomic_flag et renvoie son état précédent : false signifie acquisition d’un drapeau auparavant effacé, true qu’il était déjà posé.

C’est la primitive de base pour tenter d’acquérir un verrou simple. L’exemple l’appelle réellement deux fois sur un drapeau initialisé par ATOMIC_FLAG_INIT : le premier appel renvoie 0, le second 1, car le drapeau reste posé.

atomic_flag est garanti lock-free, mais une attente active peut affamer des threads, consommer le CPU et se bloquer si le même thread réacquiert. La forme sans _explicit utilise memory_order_seq_cst ; un spinlock typique utilise acquire à l’acquisition réussie et release dans atomic_flag_clear_explicit. Le drapeau doit être initialisé puis explicitement effacé.

Exemples

#include <stdatomic.h>
#include <stdbool.h>
#include <stdio.h>

int main(void) {
    atomic_flag flag = ATOMIC_FLAG_INIT;
    bool first = atomic_flag_test_and_set(&flag);
    bool second = atomic_flag_test_and_set(&flag);
    printf("%d %d\n", first, second);
    return 0;
}

Résultat

0 1

C’est la primitive de base pour tenter d’acquérir un verrou simple. L’exemple l’appelle réellement deux fois sur un drapeau initialisé par `ATOMIC_FLAG_INIT` : le premier appel renvoie `0`, le second `1`, car le drapeau reste posé.

Sources