CKTIS / C
atomic_fetch_sub — funzione generica atomica C23
`atomic_fetch_sub(object, operand)` di `<stdatomic.h>` sottrae atomicamente `operand` da un oggetto intero o puntatore atomico e restituisce il valore precedente. È un’unica operazione read-modify-write.
Versione: C23
Sintassi
C atomic_fetch_sub(volatile A *object, M operand);atomic_fetch_sub(object, operand) di <stdatomic.h> sottrae atomicamente operand da un oggetto intero o puntatore atomico e restituisce il valore precedente. È un’unica operazione read-modify-write.
Serve a diminuire un contatore condiviso senza aggiornamenti persi quando il vecchio valore occorre per una decisione. L’esempio sottrae davvero 6 da 20: restituisce il precedente 20 e lo stato successivo è 14.
La forma senza _explicit usa memory_order_seq_cst e può non essere lock-free. Non satura a zero: l’aritmetica intera atomica con segno usa complemento a due senza overflow indefinito, quella unsigned avvolge modulo; per un puntatore atomico l’operando è ptrdiff_t e il risultato può essere un indirizzo non valido. 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 remaining = 20;
int previous = atomic_fetch_sub(&remaining, 6);
printf("%d %d\n", previous, atomic_load(&remaining));
return 0;
}
Risultato
20 14
Serve a diminuire un contatore condiviso senza aggiornamenti persi quando il vecchio valore occorre per una decisione. L’esempio sottrae davvero `6` da `20`: restituisce il precedente `20` e lo stato successivo è `14`.