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

CKTIS / C

atomic_exchange — fonction générique atomique C23

`atomic_exchange(object, desired)` de `<stdatomic.h>` effectue une seule opération atomique read-modify-write : elle stocke `desired` dans `*object` et renvoie la valeur détenue juste avant l’échange.

Version : C23

Syntaxe

C atomic_exchange(volatile A *object, C desired);

atomic_exchange(object, desired) de <stdatomic.h> effectue une seule opération atomique read-modify-write : elle stocke desired dans *object et renvoie la valeur détenue juste avant l’échange.

Elle sert à prendre possession d’un état ou pointeur atomique lorsque l’ancien propriétaire est requis dans la même étape linéarisable. L’exemple remplace réellement 5 par 9 ; il renvoie 5, puis atomic_load lit 9.

object doit viser un objet atomique compatible correctement initialisé ; l’opération n’est pas forcément lock-free. La forme sans _explicit utilise memory_order_seq_cst. Le retour est l’ancienne valeur, pas la nouvelle, et échanger un objet ne synchronise pas à lui seul des données indépendantes sans protocole mémoire correct.

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 value = 5;
    int previous = atomic_exchange(&value, 9);
    printf("%d %d\n", previous, atomic_load(&value));
    return 0;
}

Résultat

5 9

Elle sert à prendre possession d’un état ou pointeur atomique lorsque l’ancien propriétaire est requis dans la même étape linéarisable. L’exemple remplace réellement `5` par `9` ; il renvoie `5`, puis `atomic_load` lit `9`.

Sources