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