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

CKTIS / C

atomic_load — fonction générique atomique C23

`atomic_load(object)` renvoie atomiquement la valeur de l’objet atomique pointé. La forme sans `_explicit` équivaut à `atomic_load_explicit(..., memory_order_seq_cst)` ; la qualification `volatile` du pointeur préserve la sémantique des registres matériels.

Version : C23

Syntaxe

C atomic_load(const volatile A *object);

atomic_load(object) renvoie atomiquement la valeur de l’objet atomique pointé. La forme sans _explicit équivaut à atomic_load_explicit(..., memory_order_seq_cst) ; la qualification volatile du pointeur préserve la sémantique des registres matériels.

Un load fournit un instantané cohérent d’un compteur ou drapeau sans course avec les écritures atomiques. L’exemple incrémente 41 en 42, puis les deux lectures réelles, séquentiellement cohérente et relaxed, renvoient 42.

atomic_load_explicit ne doit employer ni memory_order_release ni memory_order_acq_rel ; relaxed garantit toujours l’atomicité et l’ordre de modification de l’objet, mais ne publie pas d’autres données. L’objet doit être initialisé et le pointeur valide ; l’opération n’est pas forcément lock-free.

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 counter = 41;
    atomic_fetch_add(&counter, 1);
    int sequential = atomic_load(&counter);
    int relaxed = atomic_load_explicit(&counter, memory_order_relaxed);
    printf("%d %d\n", sequential, relaxed);
    return 0;
}

Résultat

42 42

Un load fournit un instantané cohérent d’un compteur ou drapeau sans course avec les écritures atomiques. L’exemple incrémente `41` en `42`, puis les deux lectures réelles, séquentiellement cohérente et relaxed, renvoient `42`.

Sources