Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti