Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

atomic_fetch_sub — atomska generička funkcija C23

`atomic_fetch_sub(object, operand)` iz `<stdatomic.h>` atomski oduzima `operand` od atomskog cjelobrojnog ili pokazivačkog objekta i vraća vrijednost prije oduzimanja. To je jedna operacija read-modify-write.

Verzija: C23

Sintaksa

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

atomic_fetch_sub(object, operand) iz <stdatomic.h> atomski oduzima operand od atomskog cjelobrojnog ili pokazivačkog objekta i vraća vrijednost prije oduzimanja. To je jedna operacija read-modify-write.

Služi smanjivanju zajedničkog brojača bez izgubljenih ažuriranja kada je stara vrijednost potrebna za odluku. Primjer doista oduzima 6 od 20: vraća prethodni 20, a stanje nakon operacije je 14.

Oblik bez _explicit koristi memory_order_seq_cst i ne mora biti lock-free. Ne zasićuje se na nuli: predznačena atomska cjelobrojna aritmetika koristi dvojni komplement bez nedefiniranog prekoračenja, nepredznačena se omata modulo; za atomski pokazivač operand je ptrdiff_t, a rezultat može biti nevaljana adresa. Izraz „atomski cjelobrojni tip” izričito isključuje _Atomic bool; zasebno propisan oblik za atomski pokazivač ostaje dopušten.

Naziv ove generičke funkcije može biti makro ili vanjski identifikator; potiskivanje makroa radi poziva stvarne funkcije ili definiranje vanjskog identifikatora tog naziva ima nedefinirano ponašanje.

Primjeri

#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

Služi smanjivanju zajedničkog brojača bez izgubljenih ažuriranja kada je stara vrijednost potrebna za odluku. Primjer doista oduzima `6` od `20`: vraća prethodni `20`, a stanje nakon operacije je `14`.

Izvori