CKTIS / C
atomic_fetch_xor — atomowa funkcja generyczna C23
`atomic_fetch_xor(object, operand)` z `<stdatomic.h>` wykonuje atomowe `*object ^= operand` na atomowym typie całkowitym i zwraca wartość sprzed przełączenia bitów. Jest to pojedyncza operacja read-modify-write.
Wersja: C23
Składnia
C atomic_fetch_xor(volatile A *object, M operand);atomic_fetch_xor(object, operand) z <stdatomic.h> wykonuje atomowe *object ^= operand na atomowym typie całkowitym i zwraca wartość sprzed przełączenia bitów. Jest to pojedyncza operacja read-modify-write.
Służy do atomowego przełączania dokładnie wybranych bitów współdzielonego stanu. Przykład rzeczywiście XOR-uje 0xA z 0x6: zwraca stare 10, a nowy wzorzec 0xC ma wartość 12.
Funkcja nie obsługuje atomowych wskaźników; wariant bez _explicit używa memory_order_seq_cst i nie musi być lock-free. XOR jest przełączeniem, nie ustawieniem zdarzenia: dwa wywołania z tą samą maską przywracają poprzedni stan, więc dwa zgłoszenia mogą się wzajemnie znieść. Maska musi mieć właściwą szerokość i znak. 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 = 0xAu;
unsigned previous = atomic_fetch_xor(&flags, 0x6u);
printf("%u %u\n", previous, atomic_load(&flags));
return 0;
}
Wynik
10 12
Służy do atomowego przełączania dokładnie wybranych bitów współdzielonego stanu. Przykład rzeczywiście XOR-uje `0xA` z `0x6`: zwraca stare `10`, a nowy wzorzec `0xC` ma wartość `12`.