Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_fetch_sub — atomowa funkcja generyczna C23

`atomic_fetch_sub(object, operand)` z `<stdatomic.h>` atomowo odejmuje `operand` od atomowego obiektu całkowitego lub wskaźnikowego i zwraca wartość sprzed odejmowania. Jest to pojedyncza operacja read-modify-write.

Wersja: C23

Składnia

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

atomic_fetch_sub(object, operand) z <stdatomic.h> atomowo odejmuje operand od atomowego obiektu całkowitego lub wskaźnikowego i zwraca wartość sprzed odejmowania. Jest to pojedyncza operacja read-modify-write.

Służy do zmniejszania współdzielonego licznika bez utraconych aktualizacji, gdy stara wartość jest potrzebna do decyzji. Przykład rzeczywiście odejmuje 6 od 20: zwraca poprzednie 20, a stan po operacji wynosi 14.

Wariant bez _explicit używa memory_order_seq_cst i nie musi być lock-free. Operacja nie nasyca się przy zerze: dla całkowitych typów atomowych arytmetyka ze znakiem używa uzupełnień do dwóch bez UB przepełnienia, a bez znaku zawija modulo; dla atomowego wskaźnika operand ma typ ptrdiff_t, a wynik może być nieprawidłowym adresem. Określenie „atomowy typ całkowity” jawnie wyklucza _Atomic bool; osobno określona postać dla atomowego wskaźnika pozostaje dozwolona.

Nazwa tej funkcji generycznej może być makrem albo identyfikatorem zewnętrznym; stłumienie makra w celu wywołania rzeczywistej funkcji lub zdefiniowanie zewnętrznego identyfikatora o tej nazwie ma niezdefiniowane zachowanie.

Przykłady

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

Wynik

20 14

Służy do zmniejszania współdzielonego licznika bez utraconych aktualizacji, gdy stara wartość jest potrzebna do decyzji. Przykład rzeczywiście odejmuje `6` od `20`: zwraca poprzednie `20`, a stan po operacji wynosi `14`.

Źródła