Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti