Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_store — funzione generica atomica C23

`atomic_store(object, desired)` sostituisce atomicamente il valore dell’oggetto puntato con `desired` e non restituisce valori. La forma senza `_explicit` usa `memory_order_seq_cst`; è una scrittura, non una read-modify-write.

Versione: C23

Sintassi

void atomic_store(volatile A *object, C desired);

atomic_store(object, desired) sostituisce atomicamente il valore dell’oggetto puntato con desired e non restituisce valori. La forma senza _explicit usa memory_order_seq_cst; è una scrittura, non una read-modify-write.

Uno store release pubblica uno stato completo che un consumatore legge con load acquire sullo stesso atomico. L’esempio memorizza 17 e poi 23; il vero load acquire osserva il valore finale 23.

atomic_store_explicit non può ricevere memory_order_consume, memory_order_acquire o memory_order_acq_rel; relaxed scrive atomicamente ma non pubblica precedenti scritture ordinarie. L’oggetto deve essere inizializzato e il puntatore valido; l’implementazione può usare un lock.

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 state = 0;
    atomic_store(&state, 17);
    atomic_store_explicit(&state, 23, memory_order_release);
    printf("%d\n", atomic_load_explicit(&state, memory_order_acquire));
    return 0;
}

Risultato

23

Uno store release pubblica uno stato completo che un consumatore legge con load acquire sullo stesso atomico. L’esempio memorizza `17` e poi `23`; il vero load acquire osserva il valore finale `23`.

Fonti