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

CKTIS / C

atomic_fetch_xor — fonction générique atomique C23

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

Version : C23

Syntaxe

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

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

Elle sert à basculer atomiquement des bits précis d’un état partagé. L’exemple applique réellement XOR entre 0xA et 0x6 : il renvoie l’ancien 10 et le nouveau motif 0xC vaut 12.

La fonction ne prend pas de pointeur atomique ; la forme sans _explicit utilise memory_order_seq_cst et n’est pas forcément lock-free. XOR bascule, il ne mémorise pas un événement : deux appels avec le même masque restaurent l’état précédent et deux signalements peuvent s’annuler. Le masque doit avoir largeur et signe voulus. 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 = 0xAu;
    unsigned previous = atomic_fetch_xor(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Résultat

10 12

Elle sert à basculer atomiquement des bits précis d’un état partagé. L’exemple applique réellement XOR entre `0xA` et `0x6` : il renvoie l’ancien `10` et le nouveau motif `0xC` vaut `12`.

Sources