Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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`.

Fonti