Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

atomic_fetch_sub — atomska generična funkcija C23

`atomic_fetch_sub(object, operand)` iz `<stdatomic.h>` atomsko odšteje `operand` od atomskega celoštevilskega ali kazalčnega objekta in vrne vrednost pred odštevanjem. To je ena operacija read-modify-write.

Različica: C23

Sintaksa

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

atomic_fetch_sub(object, operand) iz <stdatomic.h> atomsko odšteje operand od atomskega celoštevilskega ali kazalčnega objekta in vrne vrednost pred odštevanjem. To je ena operacija read-modify-write.

Primerna je za zmanjševanje skupnega števca brez izgubljenih posodobitev, kadar je stara vrednost potrebna za odločitev. Primer res odšteje 6 od 20: vrne prejšnje 20, stanje po operaciji pa je 14.

Oblika brez _explicit uporablja memory_order_seq_cst in ni nujno lock-free. Pri ničli se ne nasiči: predznačena atomska celoštevilska aritmetika uporablja dvojni komplement brez nedoločenega preliva, nepredznačena se ovije modulo; pri atomskem kazalcu je operand ptrdiff_t, rezultat pa je lahko neveljaven naslov. Izraz »atomski celoštevilski tip« izrecno izključuje _Atomic bool; ločeno določena oblika za atomski kazalec ostaja dovoljena.

Ime te generične funkcije je lahko makro ali zunanji identifikator; zatiranje makra za klic dejanske funkcije ali definiranje zunanjega identifikatorja s tem imenom ima nedoločeno vedenje.

Primeri

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

Rezultat

20 14

Primerna je za zmanjševanje skupnega števca brez izgubljenih posodobitev, kadar je stara vrednost potrebna za odločitev. Primer res odšteje `6` od `20`: vrne prejšnje `20`, stanje po operaciji pa je `14`.

Viri