CKTIS / C
atomic_fetch_add — funzione generica atomica C23
`atomic_fetch_add(object, operand)` di `<stdatomic.h>` aggiunge atomicamente `operand` a un oggetto intero o puntatore atomico e restituisce il valore precedente. È un’unica operazione read-modify-write.
Versione: C23
Sintassi
C atomic_fetch_add(volatile A *object, M operand);atomic_fetch_add(object, operand) di <stdatomic.h> aggiunge atomicamente operand a un oggetto intero o puntatore atomico e restituisce il valore precedente. È un’unica operazione read-modify-write.
Serve ad assegnare numeri progressivi unici o incrementare un contatore condiviso senza aggiornamenti persi. L’esempio aggiunge davvero 3 a 10: restituisce il vecchio ticket 10 e lo stato successivo è 13.
La forma senza _explicit usa memory_order_seq_cst, ma può non essere lock-free. Per interi atomici l’aritmetica con segno usa complemento a due senza risultato di overflow indefinito; per un puntatore atomico l’operando è ptrdiff_t e il risultato può essere un indirizzo non valido. Il ritorno è sempre il vecchio valore. L’espressione «tipo intero atomico» esclude esplicitamente _Atomic bool; resta ammessa la forma specificata separatamente per puntatori atomici.
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 tickets = 10;
int previous = atomic_fetch_add(&tickets, 3);
printf("%d %d\n", previous, atomic_load(&tickets));
return 0;
}
Risultato
10 13
Serve ad assegnare numeri progressivi unici o incrementare un contatore condiviso senza aggiornamenti persi. L’esempio aggiunge davvero `3` a `10`: restituisce il vecchio ticket `10` e lo stato successivo è `13`.