Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atomic_exchange — atomowa funkcja generyczna C23

`atomic_exchange(object, desired)` z `<stdatomic.h>` wykonuje jedną atomową operację read-modify-write: zapisuje `desired` do `*object` i zwraca wartość, którą obiekt miał bezpośrednio przed zamianą.

Wersja: C23

Składnia

C atomic_exchange(volatile A *object, C desired);

atomic_exchange(object, desired) z <stdatomic.h> wykonuje jedną atomową operację read-modify-write: zapisuje desired do *object i zwraca wartość, którą obiekt miał bezpośrednio przed zamianą.

Nadaje się do przejęcia atomowego stanu lub wskaźnika, gdy potrzebujesz poprzedniego właściciela w tym samym liniaryzowalnym kroku. Przykład naprawdę zamienia 5 na 9; zwraca 5, a późniejszy atomic_load odczytuje 9.

object musi wskazywać zgodny, poprawnie zainicjalizowany obiekt atomowy; operacja nie musi być lock-free. Wariant bez _explicit używa memory_order_seq_cst. Zwrócona wartość nie jest wartością nową, a atomowa zamiana jednego obiektu sama nie synchronizuje niezależnych danych bez właściwego protokołu pamięci.

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_int value = 5;
    int previous = atomic_exchange(&value, 9);
    printf("%d %d\n", previous, atomic_load(&value));
    return 0;
}

Wynik

5 9

Nadaje się do przejęcia atomowego stanu lub wskaźnika, gdy potrzebujesz poprzedniego właściciela w tym samym liniaryzowalnym kroku. Przykład naprawdę zamienia `5` na `9`; zwraca `5`, a późniejszy `atomic_load` odczytuje `9`.

Źródła