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

CKTIS / C

atomic_fetch_and — fonction générique atomique C23

`atomic_fetch_and(object, operand)` de `<stdatomic.h>` effectue atomiquement `*object &= operand` sur un type entier atomique et renvoie la valeur antérieure. C’est une seule opération read-modify-write.

Version : C23

Syntaxe

C atomic_fetch_and(volatile A *object, M operand);

atomic_fetch_and(object, operand) de <stdatomic.h> effectue atomiquement *object &= operand sur un type entier atomique et renvoie la valeur antérieure. C’est une seule opération read-modify-write.

Elle sert à effacer des bits choisis concurremment sans écraser les indicateurs posés entre-temps par d’autres threads. L’exemple part de 0x7, efface atomiquement le bit 0x2 via ~0x2u, renvoie l’ancien 7 et laisse 5.

La fonction n’accepte pas de pointeur atomique ; object doit viser un entier atomique compatible initialisé. La forme sans _explicit utilise memory_order_seq_cst et n’est pas forcément lock-free. Le masque doit avoir largeur et signe voulus ; une opération sur ce masque ne crée pas d’invariant couvrant d’autres objets atomiques. Les types entiers atomiques pris en charge excluent explicitement _Atomic bool ; cette opération n’a pas de forme pour pointeur.

Le nom de cette fonction générique peut être une macro ou un identificateur externe ; supprimer la macro pour appeler une fonction réelle, ou définir un identificateur externe de ce nom, a un comportement indéfini.

Exemples

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

int main(void) {
    atomic_uint flags = 0x7u;
    unsigned previous = atomic_fetch_and(&flags, ~0x2u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Résultat

7 5

Elle sert à effacer des bits choisis concurremment sans écraser les indicateurs posés entre-temps par d’autres threads. L’exemple part de `0x7`, efface atomiquement le bit `0x2` via `~0x2u`, renvoie l’ancien `7` et laisse `5`.

Sources