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