CKTIS / C
atomic_exchange — funzione generica atomica C23
`atomic_exchange(object, desired)` di `<stdatomic.h>` esegue un’unica operazione atomica read-modify-write: memorizza `desired` in `*object` e restituisce il valore presente immediatamente prima dello scambio.
Versione: C23
Sintassi
C atomic_exchange(volatile A *object, C desired);atomic_exchange(object, desired) di <stdatomic.h> esegue un’unica operazione atomica read-modify-write: memorizza desired in *object e restituisce il valore presente immediatamente prima dello scambio.
Serve a prendere possesso di uno stato o puntatore atomico quando occorre il proprietario precedente nello stesso passo linearizzabile. L’esempio cambia davvero 5 in 9; restituisce 5 e il successivo atomic_load legge 9.
object deve puntare a un oggetto atomico compatibile e correttamente inizializzato; l’operazione può non essere lock-free. La forma senza _explicit usa memory_order_seq_cst. Il ritorno è il vecchio valore, non il nuovo, e lo scambio di un oggetto non sincronizza dati indipendenti senza un protocollo di memoria corretto.
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 = 5;
int previous = atomic_exchange(&value, 9);
printf("%d %d\n", previous, atomic_load(&value));
return 0;
}
Risultato
5 9
Serve a prendere possesso di uno stato o puntatore atomico quando occorre il proprietario precedente nello stesso passo linearizzabile. L’esempio cambia davvero `5` in `9`; restituisce `5` e il successivo `atomic_load` legge `9`.