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

CKTIS / C

atomic_init — fonction générique atomique C23

`atomic_init(obj, value)` de `<stdatomic.h>` initialise l’objet atomique pointé avec `value`, y compris tout état supplémentaire requis par l’implémentation, et ne renvoie rien. Si le stockage n’a pas de type déclaré, l’appel lui donne le type effectif atomique `A`.

Version : C23

Syntaxe

void atomic_init(volatile A *obj, C value);

atomic_init(obj, value) de <stdatomic.h> initialise l’objet atomique pointé avec value, y compris tout état supplémentaire requis par l’implémentation, et ne renvoie rien. Si le stockage n’a pas de type déclaré, l’appel lui donne le type effectif atomique A.

Elle place un objet atomique automatique ou alloué dans un état valide avant de publier son adresse aux autres threads. L’exemple initialise réellement un atomic_int à 42, puis le lit avec atomic_load.

atomic_init ne synchronise pas : tout accès concurrent pendant l’initialisation, même atomique, crée une course de données. Une écriture non atomique dans un octet quelconque, y compris par memcpy ou memset, rend la représentation indéterminée. L’appel depuis un gestionnaire de signal a un comportement indéfini sauf si le signal provient de abort ou raise ; l’initialisation par défaut valide les objets statiques et de durée thread autres que atomic_flag.

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;
    atomic_init(&value, 42);
    printf("%d\n", atomic_load(&value));
    return 0;
}

Résultat

42

Elle place un objet atomique automatique ou alloué dans un état valide avant de publier son adresse aux autres threads. L’exemple initialise réellement un `atomic_int` à `42`, puis le lit avec `atomic_load`.

Sources