CKTIS / C
atomic_compare_exchange_weak — atomaire generieke C23-functie
`atomic_compare_exchange_weak(object, expected, desired)` heeft dezelfde opslag bij succes en bijwerking van `*expected` bij falen als `strong`, maar mag spurieus `false` retourneren terwijl de waarden gelijk zijn. De read-modify-write op `object` blijft atomair; de schrijfbewerking naar `expected` bij mislukking is een gewone niet-atomaire schrijfbewerking.
Versie: C23
Syntax
bool atomic_compare_exchange_weak(volatile A *object, C *expected, C desired);atomic_compare_exchange_weak(object, expected, desired) heeft dezelfde opslag bij succes en bijwerking van *expected bij falen als strong, maar mag spurieus false retourneren terwijl de waarden gelijk zijn. De read-modify-write op object blijft atomair; de schrijfbewerking naar expected bij mislukking is een gewone niet-atomaire schrijfbewerking.
Het is vooral bedoeld voor herhaallussen waarin incidenteel spurieus falen het algoritme niet verandert en een goedkopere hardware-instructie kan toelaten. Het voorbeeld begint met fout expected = 3; de eerste mislukking schrijft daar 7, waarna de lus de atomaire waarde uiteindelijk naar 9 verandert.
Code moet blijven proberen bij inmenging van andere threads en desired herberekenen als dit van de bijgewerkte expected afhangt. De vorm zonder _explicit gebruikt memory_order_seq_cst; ongeldige pointers, een race op niet-atomaire expected of één poging aannemen schendt het contract. ABA blijft mogelijk. Schending van de pointervereisten — waaronder een ongeldige pointer, een incompatibel aangewezen type of een niet-wijzigbaar expected-object — heeft ongedefinieerd gedrag; een ongesynchroniseerde race op expected eveneens.
C23 vergelijkt de inhoud, dus de waarderepresentaties die door object en expected worden aangewezen, en niet alleen hun wiskundige gelijkheid; de atomaire read-modify-write betreft object, terwijl expected gewone niet-atomaire opslag is. Gelijktijdige ongesynchroniseerde toegang tot expected veroorzaakt een data race en ongedefinieerd gedrag. De naam van deze generieke functie kan een macro of een externe identifier zijn; de macro onderdrukken om een echte functie aan te roepen, of een externe identifier met die naam definiëren, heeft ongedefinieerd gedrag.
Voorbeelden
#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;
}
Resultaat
9 7 1
Het is vooral bedoeld voor herhaallussen waarin incidenteel spurieus falen het algoritme niet verandert en een goedkopere hardware-instructie kan toelaten. Het voorbeeld begint met fout `expected = 3`; de eerste mislukking schrijft daar `7`, waarna de lus de atomaire waarde uiteindelijk naar `9` verandert.