Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła