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

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

Zdroje