Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_fetch_or — atomowa funkcja generyczna C23

`atomic_fetch_or(object, operand)` z `<stdatomic.h>` wykonuje atomowe `*object |= operand` na atomowym typie całkowitym i zwraca wartość sprzed ustawienia bitów. Jest to pojedyncza operacja read-modify-write.

Wersja: C23

Składnia

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

atomic_fetch_or(object, operand) z <stdatomic.h> wykonuje atomowe *object |= operand na atomowym typie całkowitym i zwraca wartość sprzed ustawienia bitów. Jest to pojedyncza operacja read-modify-write.

Służy do współbieżnego zgłaszania niezależnych flag: ustawienie bitu przez jeden wątek nie gubi bitów ustawionych przez inne. Przykład naprawdę łączy początkowe 0x1 z maską 0x6, zwraca stare 1 i pozostawia wszystkie trzy bity, czyli 7.

Funkcja nie obsługuje atomowych wskaźników; object musi być zgodnym, zainicjalizowanym atomowym typem całkowitym. Wariant bez _explicit używa memory_order_seq_cst i nie musi być lock-free. OR może tylko ustawiać bity, nie czyścić ich, a odczyt starej maski nie jest automatycznie potwierdzeniem obsługi zdarzeń przez inny wątek. 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 = 0x1u;
    unsigned previous = atomic_fetch_or(&flags, 0x6u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Wynik

1 7

Służy do współbieżnego zgłaszania niezależnych flag: ustawienie bitu przez jeden wątek nie gubi bitów ustawionych przez inne. Przykład naprawdę łączy początkowe `0x1` z maską `0x6`, zwraca stare `1` i pozostawia wszystkie trzy bity, czyli `7`.

Źródła