Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti