Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_fetch_add — atomowa funkcja generyczna C23

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

Wersja: C23

Składnia

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

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

Nadaje się do przydzielania unikatowych numerów lub zwiększania współdzielonego licznika bez utraconych aktualizacji. Przykład rzeczywiście dodaje 3 do 10: zwracana wartość to stary bilet 10, a stan po operacji wynosi 13.

Wariant bez _explicit używa memory_order_seq_cst, lecz operacja nie musi być lock-free. Dla atomowych typów całkowitych arytmetyka ze znakiem ma zdefiniowaną reprezentację uzupełnień do dwóch i nie powoduje UB przepełnienia; dla atomowego wskaźnika operand ma typ ptrdiff_t, a wynik może być nieprawidłowym adresem. Zwracana jest zawsze wartość stara. 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 tickets = 10;
    int previous = atomic_fetch_add(&tickets, 3);
    printf("%d %d\n", previous, atomic_load(&tickets));
    return 0;
}

Wynik

10 13

Nadaje się do przydzielania unikatowych numerów lub zwiększania współdzielonego licznika bez utraconych aktualizacji. Przykład rzeczywiście dodaje `3` do `10`: zwracana wartość to stary bilet `10`, a stan po operacji wynosi `13`.

Źródła