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

CKTIS / C

atomic_fetch_add — fonction générique atomique C23

`atomic_fetch_add(object, operand)` de `<stdatomic.h>` ajoute atomiquement `operand` à un objet entier ou pointeur atomique et renvoie la valeur antérieure. C’est une seule opération read-modify-write.

Version : C23

Syntaxe

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

atomic_fetch_add(object, operand) de <stdatomic.h> ajoute atomiquement operand à un objet entier ou pointeur atomique et renvoie la valeur antérieure. C’est une seule opération read-modify-write.

Elle sert à attribuer des numéros uniques ou incrémenter un compteur partagé sans mise à jour perdue. L’exemple ajoute réellement 3 à 10 : l’ancien ticket renvoyé vaut 10 et l’état après l’opération vaut 13.

La forme sans _explicit utilise memory_order_seq_cst, mais n’est pas forcément lock-free. Pour les entiers atomiques, l’arithmétique signée est définie en complément à deux sans résultat de débordement indéfini ; pour un pointeur atomique, l’opérande est ptrdiff_t et le résultat peut être une adresse invalide. Le retour est toujours l’ancienne valeur. L’expression « type entier atomique » exclut explicitement _Atomic bool ; la forme distincte pour pointeur atomique reste autorisée.

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_int tickets = 10;
    int previous = atomic_fetch_add(&tickets, 3);
    printf("%d %d\n", previous, atomic_load(&tickets));
    return 0;
}

Résultat

10 13

Elle sert à attribuer des numéros uniques ou incrémenter un compteur partagé sans mise à jour perdue. L’exemple ajoute réellement `3` à `10` : l’ancien ticket renvoyé vaut `10` et l’état après l’opération vaut `13`.

Sources