CKTIS / C
atomic_fetch_and — atomowa funkcja generyczna C23
`atomic_fetch_and(object, operand)` z `<stdatomic.h>` wykonuje atomowe `*object &= operand` na atomowym typie całkowitym i zwraca wartość sprzed operacji. Całość jest pojedynczą operacją read-modify-write.
Wersja: C23
Składnia
C atomic_fetch_and(volatile A *object, M operand);atomic_fetch_and(object, operand) z <stdatomic.h> wykonuje atomowe *object &= operand na atomowym typie całkowitym i zwraca wartość sprzed operacji. Całość jest pojedynczą operacją read-modify-write.
Służy do współbieżnego czyszczenia wybranych bitów bez nadpisywania flag ustawionych w międzyczasie przez inne wątki. Przykład startuje z maską 0x7, atomowo czyści bit 0x2 przez ~0x2u, zwraca stare 7 i pozostawia 5.
Funkcja nie działa na atomowych wskaźnikach, a object musi wskazywać zgodny, zainicjalizowany atomowy typ całkowity. Wariant bez _explicit używa memory_order_seq_cst i nie musi być lock-free. Maska musi mieć zamierzoną szerokość oraz znak; operacja na jednej masce nie tworzy niezmiennika obejmującego inne obiekty atomowe. Obsługiwane atomowe typy całkowite jawnie wykluczają _Atomic bool; dla tej operacji nie istnieje postać wskaźnikowa.
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_uint flags = 0x7u;
unsigned previous = atomic_fetch_and(&flags, ~0x2u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Wynik
7 5
Służy do współbieżnego czyszczenia wybranych bitów bez nadpisywania flag ustawionych w międzyczasie przez inne wątki. Przykład startuje z maską `0x7`, atomowo czyści bit `0x2` przez `~0x2u`, zwraca stare `7` i pozostawia `5`.