Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti