CKTIS / C
atomic_init — funzione generica atomica C23
`atomic_init(obj, value)` di `<stdatomic.h>` inizializza l’oggetto atomico puntato con `value`, compreso lo stato aggiuntivo richiesto dall’implementazione, e non restituisce valori. Se la memoria non ha un tipo dichiarato, la chiamata le assegna il tipo effettivo atomico `A`.
Versione: C23
Sintassi
void atomic_init(volatile A *obj, C value);atomic_init(obj, value) di <stdatomic.h> inizializza l’oggetto atomico puntato con value, compreso lo stato aggiuntivo richiesto dall’implementazione, e non restituisce valori. Se la memoria non ha un tipo dichiarato, la chiamata le assegna il tipo effettivo atomico A.
Serve a rendere valido un oggetto atomico automatico o allocato prima di pubblicarne l’indirizzo ad altri thread. L’esempio inizializza davvero un atomic_int a 42 e poi lo legge con atomic_load.
atomic_init non sincronizza: ogni accesso concorrente durante l’inizializzazione, anche atomico, crea una data race. Una scrittura non atomica in qualsiasi byte, anche tramite memcpy o memset, rende la rappresentazione indeterminata. Chiamarla da un gestore di segnali ha comportamento indefinito salvo segnali prodotti da abort o raise; l’inizializzazione predefinita rende validi gli oggetti statici e thread-local diversi da atomic_flag.
Il nome di questa funzione generica può essere una macro o un identificatore esterno; sopprimere la macro per chiamare una funzione reale o definire un identificatore esterno con quel nome ha comportamento indefinito.
Esempi
#include <stdatomic.h>
#include <stdio.h>
int main(void) {
atomic_int value;
atomic_init(&value, 42);
printf("%d\n", atomic_load(&value));
return 0;
}
Risultato
42
Serve a rendere valido un oggetto atomico automatico o allocato prima di pubblicarne l’indirizzo ad altri thread. L’esempio inizializza davvero un `atomic_int` a `42` e poi lo legge con `atomic_load`.