CKTIS / C
atomic_compare_exchange_weak — atomare generische C23-Funktion
`atomic_compare_exchange_weak(object, expected, desired)` besitzt dieselbe Erfolgsspeicherung und Aktualisierung von `*expected` bei Misserfolg wie `strong`, darf aber selbst bei gleichen Werten fälschlich `false` liefern. Das Read-Modify-Write auf `object` bleibt atomar; das Schreiben nach `expected` bei Misserfolg ist ein gewöhnlicher nicht atomarer Schreibzugriff.
Version: C23
Syntax
bool atomic_compare_exchange_weak(volatile A *object, C *expected, C desired);atomic_compare_exchange_weak(object, expected, desired) besitzt dieselbe Erfolgsspeicherung und Aktualisierung von *expected bei Misserfolg wie strong, darf aber selbst bei gleichen Werten fälschlich false liefern. Das Read-Modify-Write auf object bleibt atomar; das Schreiben nach expected bei Misserfolg ist ein gewöhnlicher nicht atomarer Schreibzugriff.
Sie ist vor allem für Wiederholungsschleifen gedacht, in denen ein gelegentliches fälschliches Scheitern den Algorithmus nicht ändert und eine billigere Hardwareinstruktion erlauben kann. Das Beispiel startet mit falschem expected = 3; der erste Misserfolg schreibt dort 7, und die Schleife ändert den Atomwert schließlich auf 9.
Code muss auch bei Eingriffen anderer Threads wiederholen und desired neu berechnen, wenn es vom aktualisierten expected abhängt. Die Form ohne _explicit nutzt memory_order_seq_cst; ungültige Zeiger, ein Rennen auf nicht atomarem expected oder die Annahme eines einzigen Versuchs verletzen den Vertrag. ABA bleibt möglich. Ein Verstoß gegen die Zeigeranforderungen — einschließlich eines ungültigen Zeigers, eines inkompatiblen Zieltyps oder eines nicht änderbaren expected-Objekts — hat undefiniertes Verhalten; ein unsynchronisiertes Datenrennen auf expected ebenfalls.
C23 vergleicht den Inhalt, also die von object und expected bezeichneten Wertdarstellungen, nicht nur ihre mathematische Gleichheit; das atomare Read-Modify-Write betrifft object, während expected gewöhnlicher nicht atomarer Speicher ist. Gleichzeitiger unsynchronisierter Zugriff auf expected erzeugt ein Datenrennen und undefiniertes Verhalten. 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 <stdbool.h>
#include <stdio.h>
int main(void) {
atomic_int value = 7;
int expected = 3;
int failures = 0;
while (!atomic_compare_exchange_weak(&value, &expected, 9)) {
++failures;
}
printf("%d %d %d\n", atomic_load(&value), expected, failures >= 1);
return 0;
}
Ergebnis
9 7 1
Sie ist vor allem für Wiederholungsschleifen gedacht, in denen ein gelegentliches fälschliches Scheitern den Algorithmus nicht ändert und eine billigere Hardwareinstruktion erlauben kann. Das Beispiel startet mit falschem `expected = 3`; der erste Misserfolg schreibt dort `7`, und die Schleife ändert den Atomwert schließlich auf `9`.