Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

atomic_fetch_add — atomska generička funkcija C23

`atomic_fetch_add(object, operand)` iz `<stdatomic.h>` atomski dodaje `operand` atomskom cjelobrojnom ili pokazivačkom objektu i vraća vrijednost prije zbrajanja. To je jedna operacija read-modify-write.

Verzija: C23

Sintaksa

C atomic_fetch_add(volatile A *object, M operand);

atomic_fetch_add(object, operand) iz <stdatomic.h> atomski dodaje operand atomskom cjelobrojnom ili pokazivačkom objektu i vraća vrijednost prije zbrajanja. To je jedna operacija read-modify-write.

Služi dodjeljivanju jedinstvenih rednih brojeva ili povećanju zajedničkog brojača bez izgubljenih ažuriranja. Primjer doista dodaje 3 na 10: vraća stari broj 10, a stanje nakon operacije je 13.

Oblik bez _explicit koristi memory_order_seq_cst, ali ne mora biti lock-free. Za atomske cijele tipove predznačena aritmetika koristi dvojni komplement bez nedefiniranog rezultata prekoračenja; za atomski pokazivač operand je ptrdiff_t, a rezultat može biti nevaljana adresa. Uvijek se vraća stara vrijednost. Izraz „atomski cjelobrojni tip” izričito isključuje _Atomic bool; zasebno propisan oblik za atomski pokazivač ostaje dopušten.

Naziv ove generičke funkcije može biti makro ili vanjski identifikator; potiskivanje makroa radi poziva stvarne funkcije ili definiranje vanjskog identifikatora tog naziva ima nedefinirano ponašanje.

Primjeri

#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;
}

Rezultat

10 13

Služi dodjeljivanju jedinstvenih rednih brojeva ili povećanju zajedničkog brojača bez izgubljenih ažuriranja. Primjer doista dodaje `3` na `10`: vraća stari broj `10`, a stanje nakon operacije je `13`.

Izvori