CKTIS / C
atomic_load — funzione generica atomica C23
`atomic_load(object)` restituisce atomicamente il valore dell’oggetto atomico puntato. La forma senza `_explicit` equivale a `atomic_load_explicit(..., memory_order_seq_cst)`; il `volatile` del puntatore preserva la semantica dei registri hardware.
Versione: C23
Sintassi
C atomic_load(const volatile A *object);atomic_load(object) restituisce atomicamente il valore dell’oggetto atomico puntato. La forma senza _explicit equivale a atomic_load_explicit(..., memory_order_seq_cst); il volatile del puntatore preserva la semantica dei registri hardware.
Un load ottiene un’istantanea coerente di un contatore o flag senza race con scrittori atomici. L’esempio incrementa 41 a 42; poi entrambe le letture reali, sequenzialmente consistente e relaxed, restituiscono 42.
atomic_load_explicit non può usare memory_order_release né memory_order_acq_rel; relaxed garantisce comunque atomicità e ordine di modifica dell’oggetto, ma non pubblica altri dati. L’oggetto deve essere inizializzato e il puntatore valido; l’operazione può non essere lock-free.
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 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;
}
Risultato
42 42
Un load ottiene un’istantanea coerente di un contatore o flag senza race con scrittori atomici. L’esempio incrementa `41` a `42`; poi entrambe le letture reali, sequenzialmente consistente e relaxed, restituiscono `42`.