atomic_fetch_sub, atomic_fetch_sub_explicit

Défini dans l'en-tête <stdatomic.h>
C atomic_fetch_sub ( volatile A * obj, M arg ) ;	(1)	(depuis C11)
C atomic_fetch_sub_explicit ( volatile A * obj, M arg, memory_order order ) ;	(2)	(depuis C11)

Remplace atomiquement la valeur pointée par obj par le résultat de la soustraction de arg à l'ancienne valeur de obj , et retourne la valeur que obj contenait précédemment. L'opération est une opération de lecture-modification-écriture. La première version ordonne les accès mémoire selon memory_order_seq_cst , la deuxième version ordonne les accès mémoire selon order .

Ceci est une fonction générique définie pour tous les types d'objets atomiques A . L'argument est un pointeur vers un type atomique volatile pour accepter les adresses des objets atomiques non volatiles et volatiles (par exemple, E/S mappées en mémoire), et la sémantique volatile est préservée lors de l'application de cette opération aux objets atomiques volatiles. M est soit le type non atomique correspondant à A si A est un type entier atomique, soit ptrdiff_t si A est un type pointeur atomique.

Il n'est pas spécifié si le nom d'une fonction générique est une macro ou un identifiant déclaré avec une liaison externe. Si une définition de macro est supprimée pour accéder à une fonction réelle (par exemple entre parenthèses comme ( atomic_fetch_sub ) ( ... ) ), ou si un programme définit un identifiant externe avec le nom d'une fonction générique, le comportement est indéfini.

Pour les types entiers signés, l'arithmétique est définie pour utiliser la représentation en complément à deux. Il n'y a pas de résultats non définis. Pour les types pointeurs, le résultat peut être une adresse non définie, mais les opérations n'ont par ailleurs aucun comportement non défini.

Table des matières 1 Paramètres 2 Valeur de retour 3 Références 4 Voir aussi

Paramètres

obj	-	pointeur vers l'objet atomique à modifier
arg	-	valeur à soustraire de la valeur stockée dans l'objet atomique
order	-	ordre de synchronisation mémoire pour cette opération : toutes les valeurs sont autorisées

Valeur de retour

La valeur précédemment détenue par l'objet atomique pointé par obj .

Références

Voir aussi

atomic_fetch_add atomic_fetch_add_explicit (C11)	addition atomique (fonction)
Documentation C++ pour atomic_fetch_sub , atomic_fetch_sub_explicit