CKTIS / C
atomic_compare_exchange_strong — fonction générique atomique C23
`atomic_compare_exchange_strong(object, expected, desired)` de `<stdatomic.h>` compare atomiquement l’atomique `*object` au non-atomique `*expected`. En cas d’égalité, elle stocke `desired` et renvoie `true` ; sinon elle écrit la valeur courante dans `*expected` et renvoie `false`, sans échec fallacieux.
Version : C23
Syntaxe
bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);atomic_compare_exchange_strong(object, expected, desired) de <stdatomic.h> compare atomiquement l’atomique *object au non-atomique *expected. En cas d’égalité, elle stocke desired et renvoie true ; sinon elle écrit la valeur courante dans *expected et renvoie false, sans échec fallacieux.
Elle convient à une tentative unique de transition d’état avec chemins distincts pour succès et désaccord réel. L’exemple effectue le remplacement 7→11, puis réessaie en attendant 7 ; ce second essai échoue et met expected à 11.
object doit viser un type atomique compatible et expected un type non atomique correspondant modifiable ; pointeurs invalides ou course sur expected sont erronés. La forme sans _explicit utilise memory_order_seq_cst. Comparer la seule valeur ne résout ni ABA ni la protection d’autres données sans protocole mémoire correct. Violer les exigences sur les pointeurs — pointeur invalide, type pointé incompatible ou objet expected non modifiable — a un comportement indéfini ; une course non synchronisée sur expected également.
C23 compare le contenu, c’est-à-dire les représentations de valeur désignées par object et expected, et non leur seule égalité mathématique ; le read-modify-write atomique porte sur object, tandis que expected est un stockage ordinaire non atomique. Un accès concurrent non synchronisé à expected crée une course de données et un comportement indéfini. 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 <stdbool.h>
#include <stdio.h>
int main(void) {
atomic_int value = 7;
int expected = 7;
bool replaced = atomic_compare_exchange_strong(&value, &expected, 11);
expected = 7;
bool rejected = atomic_compare_exchange_strong(&value, &expected, 13);
printf("%d %d %d %d\n", replaced, rejected, atomic_load(&value), expected);
return 0;
}
Résultat
1 0 11 11
Elle convient à une tentative unique de transition d’état avec chemins distincts pour succès et désaccord réel. L’exemple effectue le remplacement `7→11`, puis réessaie en attendant `7` ; ce second essai échoue et met `expected` à `11`.