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

CKTIS / C

atomic_fetch_or — fonction générique atomique C23

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

Version : C23

Syntaxe

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

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

Elle sert à signaler concurremment des indicateurs indépendants : un bit posé par un thread ne perd pas ceux posés par les autres. L’exemple combine réellement 0x1 avec le masque 0x6, renvoie l’ancien 1 et laisse les trois bits à 7.

La fonction ne prend pas de pointeur atomique ; object doit être un entier atomique compatible initialisé. La forme sans _explicit utilise memory_order_seq_cst et n’est pas forcément lock-free. OR pose des bits mais ne les efface pas, et lire l’ancien masque n’accuse pas automatiquement réception d’un événement par un autre thread. 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 = 0x1u;
    unsigned previous = atomic_fetch_or(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Résultat

1 7

Elle sert à signaler concurremment des indicateurs indépendants : un bit posé par un thread ne perd pas ceux posés par les autres. L’exemple combine réellement `0x1` avec le masque `0x6`, renvoie l’ancien `1` et laisse les trois bits à `7`.

Sources