CKTIS / C
atomic_fetch_sub — fonction générique atomique C23
`atomic_fetch_sub(object, operand)` de `<stdatomic.h>` soustrait atomiquement `operand` d’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_sub(volatile A *object, M operand);atomic_fetch_sub(object, operand) de <stdatomic.h> soustrait atomiquement operand d’un objet entier ou pointeur atomique et renvoie la valeur antérieure. C’est une seule opération read-modify-write.
Elle sert à diminuer un compteur partagé sans mise à jour perdue lorsque l’ancienne valeur participe à une décision. L’exemple soustrait réellement 6 de 20 : il renvoie l’ancien 20, puis l’état vaut 14.
La forme sans _explicit utilise memory_order_seq_cst et n’est pas forcément lock-free. Elle ne sature pas à zéro : l’arithmétique entière atomique signée utilise le complément à deux sans débordement indéfini, l’arithmétique non signée boucle modulo ; pour un pointeur atomique, l’opérande est ptrdiff_t et le résultat peut être une adresse invalide. 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 remaining = 20;
int previous = atomic_fetch_sub(&remaining, 6);
printf("%d %d\n", previous, atomic_load(&remaining));
return 0;
}
Résultat
20 14
Elle sert à diminuer un compteur partagé sans mise à jour perdue lorsque l’ancienne valeur participe à une décision. L’exemple soustrait réellement `6` de `20` : il renvoie l’ancien `20`, puis l’état vaut `14`.