CKTIS / C
atomic_exchange — atomická generická funkce C23
`atomic_exchange(object, desired)` z `<stdatomic.h>` provede jedinou atomickou operaci read-modify-write: uloží `desired` do `*object` a vrátí hodnotu, kterou objekt měl bezprostředně před výměnou.
Verze: C23
Syntaxe
C atomic_exchange(volatile A *object, C desired);atomic_exchange(object, desired) z <stdatomic.h> provede jedinou atomickou operaci read-modify-write: uloží desired do *object a vrátí hodnotu, kterou objekt měl bezprostředně před výměnou.
Hodí se k převzetí atomického stavu či ukazatele, když je předchozí vlastník potřeba v témže linearizovatelném kroku. Příklad skutečně změní 5 na 9; vrátí 5 a následný atomic_load čte 9.
object musí ukazovat na kompatibilní správně inicializovaný atomický objekt; operace nemusí být lock-free. Forma bez _explicit používá memory_order_seq_cst. Vrací starou, ne novou hodnotu, a výměna jednoho objektu sama nesynchronizuje nezávislá data bez správného paměťového protokolu.
Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.
Příklady
#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;
}
Výsledek
5 9
Hodí se k převzetí atomického stavu či ukazatele, když je předchozí vlastník potřeba v témže linearizovatelném kroku. Příklad skutečně změní `5` na `9`; vrátí `5` a následný `atomic_load` čte `9`.