Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła