Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

atomic_fetch_sub — atómová generická funkcia C23

`atomic_fetch_sub(object, operand)` z `<stdatomic.h>` atómovo odpočíta `operand` od atómového celočíselného alebo ukazovateľového objektu a vráti hodnotu pred odčítaním. Ide o jedinú operáciu read-modify-write.

Verzia: C23

Syntax

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

atomic_fetch_sub(object, operand) z <stdatomic.h> atómovo odpočíta operand od atómového celočíselného alebo ukazovateľového objektu a vráti hodnotu pred odčítaním. Ide o jedinú operáciu read-modify-write.

Hodí sa na zníženie zdieľaného počítadla bez stratených aktualizácií, keď je stará hodnota potrebná na rozhodnutie. Príklad skutočne odpočíta 6 od 20: vráti predchádzajúce 20 a stav po operácii je 14.

Forma bez _explicit používa memory_order_seq_cst a nemusí byť lock-free. Nesaturuje na nule: znamienková atómová celočíselná aritmetika používa dvojkový doplnok bez nedefinovaného pretečenia, bezznamienková sa obtáča modulo; pri atómovom ukazovateli je operand ptrdiff_t a výsledkom môže byť neplatná adresa. Pojem „atómový celočíselný typ“ výslovne vylučuje _Atomic bool; samostatne určená forma pre atómový ukazovateľ zostáva povolená.

Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.

Prí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ýsledok

20 14

Hodí sa na zníženie zdieľaného počítadla bez stratených aktualizácií, keď je stará hodnota potrebná na rozhodnutie. Príklad skutočne odpočíta `6` od `20`: vráti predchádzajúce `20` a stav po operácii je `14`.

Zdroje