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

CKTIS / C

atomic_store — fonction générique atomique C23

`atomic_store(object, desired)` remplace atomiquement la valeur de l’objet pointé par `desired` et ne renvoie rien. La forme sans `_explicit` utilise `memory_order_seq_cst` ; c’est une écriture, pas une opération read-modify-write.

Version : C23

Syntaxe

void atomic_store(volatile A *object, C desired);

atomic_store(object, desired) remplace atomiquement la valeur de l’objet pointé par desired et ne renvoie rien. La forme sans _explicit utilise memory_order_seq_cst ; c’est une écriture, pas une opération read-modify-write.

Un store release publie un état terminé qu’un consommateur lit par un load acquire sur le même objet atomique. L’exemple stocke 17, puis 23 ; la vraie lecture acquire observe la valeur finale 23.

atomic_store_explicit ne doit recevoir ni memory_order_consume, ni memory_order_acquire, ni memory_order_acq_rel ; relaxed écrit atomiquement sans publier les écritures ordinaires antérieures. L’objet doit être initialisé et le pointeur valide ; l’implémentation peut utiliser un verrou.

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 state = 0;
    atomic_store(&state, 17);
    atomic_store_explicit(&state, 23, memory_order_release);
    printf("%d\n", atomic_load_explicit(&state, memory_order_acquire));
    return 0;
}

Résultat

23

Un store release publie un état terminé qu’un consommateur lit par un load acquire sur le même objet atomique. L’exemple stocke `17`, puis `23` ; la vraie lecture acquire observe la valeur finale `23`.

Sources