Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

atomic_fetch_add — atomická generická funkce C23

`atomic_fetch_add(object, operand)` z `<stdatomic.h>` atomicky přičte `operand` k atomickému celočíselnému nebo ukazatelovému objektu a vrátí hodnotu před přičtením. Jde o jedinou operaci read-modify-write.

Verze: C23

Syntaxe

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

atomic_fetch_add(object, operand) z <stdatomic.h> atomicky přičte operand k atomickému celočíselnému nebo ukazatelovému objektu a vrátí hodnotu před přičtením. Jde o jedinou operaci read-modify-write.

Hodí se k přidělování jedinečných pořadových čísel či zvyšování sdíleného čítače bez ztracených aktualizací. Příklad skutečně přičte 3 k 10: vrácený starý lístek je 10 a stav po operaci 13.

Forma bez _explicit používá memory_order_seq_cst, ale nemusí být lock-free. U atomických celých typů používá znaménková aritmetika dvojkový doplněk bez nedefinovaného výsledku přetečení; u atomického ukazatele je operand ptrdiff_t a výsledkem může být neplatná adresa. Vrací se vždy stará hodnota. Pojem „atomický celočíselný typ“ výslovně vylučuje _Atomic bool; samostatně určená forma pro atomický ukazatel zůstává povolena.

Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.

Příklady

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

Výsledek

10 13

Hodí se k přidělování jedinečných pořadových čísel či zvyšování sdíleného čítače bez ztracených aktualizací. Příklad skutečně přičte `3` k `10`: vrácený starý lístek je `10` a stav po operaci `13`.

Zdroje