CKTIS / C
atomic_exchange — atomare generische C23-Funktion
`atomic_exchange(object, desired)` aus `<stdatomic.h>` führt eine atomare Read-Modify-Write-Operation aus: Sie speichert `desired` in `*object` und liefert den Wert, den das Objekt unmittelbar vor dem Austausch hatte.
Version: C23
Syntax
C atomic_exchange(volatile A *object, C desired);atomic_exchange(object, desired) aus <stdatomic.h> führt eine atomare Read-Modify-Write-Operation aus: Sie speichert desired in *object und liefert den Wert, den das Objekt unmittelbar vor dem Austausch hatte.
Sie eignet sich zur Übernahme eines atomaren Zustands oder Zeigers, wenn der vorherige Besitzer im selben linearisierbaren Schritt benötigt wird. Das Beispiel ändert tatsächlich 5 in 9; zurück kommt 5, der spätere atomic_load liest 9.
object muss auf ein passendes, korrekt initialisiertes atomares Objekt zeigen; die Operation muss nicht lock-free sein. Die Form ohne _explicit nutzt memory_order_seq_cst. Zurück kommt der alte, nicht der neue Wert, und der Austausch eines Objekts synchronisiert ohne korrektes Speicherprotokoll keine unabhängigen Daten.
Der Name dieser generischen Funktion darf ein Makro oder ein externer Bezeichner sein; das Unterdrücken des Makros zum Aufruf einer tatsächlichen Funktion oder das Definieren eines externen Bezeichners dieses Namens hat undefiniertes Verhalten.
Beispiele
#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;
}
Ergebnis
5 9
Sie eignet sich zur Übernahme eines atomaren Zustands oder Zeigers, wenn der vorherige Besitzer im selben linearisierbaren Schritt benötigt wird. Das Beispiel ändert tatsächlich `5` in `9`; zurück kommt `5`, der spätere `atomic_load` liest `9`.