CKTIS / C
atomic_fetch_sub — atomická generická funkce C23
`atomic_fetch_sub(object, operand)` z `<stdatomic.h>` atomicky odečte `operand` od atomického celočíselného nebo ukazatelového objektu a vrátí hodnotu před odečtením. Jde o jedinou operaci read-modify-write.
Verze: C23
Syntaxe
C atomic_fetch_sub(volatile A *object, M operand);atomic_fetch_sub(object, operand) z <stdatomic.h> atomicky odečte operand od atomického celočíselného nebo ukazatelového objektu a vrátí hodnotu před odečtením. Jde o jedinou operaci read-modify-write.
Hodí se ke snížení sdíleného čítače bez ztracených aktualizací, když je stará hodnota potřeba pro rozhodnutí. Příklad skutečně odečte 6 od 20: vrátí předchozí 20 a stav po operaci je 14.
Forma bez _explicit používá memory_order_seq_cst a nemusí být lock-free. Nesaturuje na nule: znaménková atomická celočíselná aritmetika používá dvojkový doplněk bez nedefinovaného přetečení, bezznaménková se obtáčí modulo; u atomického ukazatele je operand ptrdiff_t a výsledkem může být neplatná adresa. 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 remaining = 20;
int previous = atomic_fetch_sub(&remaining, 6);
printf("%d %d\n", previous, atomic_load(&remaining));
return 0;
}
Výsledek
20 14
Hodí se ke snížení sdíleného čítače bez ztracených aktualizací, když je stará hodnota potřeba pro rozhodnutí. Příklad skutečně odečte `6` od `20`: vrátí předchozí `20` a stav po operaci je `14`.