CKTIS / C
atomic_compare_exchange_weak — atómová generická funkcia C23
`atomic_compare_exchange_weak(object, expected, desired)` má rovnaké uloženie pri úspechu a aktualizáciu `*expected` pri neúspechu ako `strong`, ale môže vrátiť `false` falošne aj pri zhodných hodnotách. Operácia read-modify-write nad `object` zostáva atómová; zápis do `expected` pri zlyhaní je bežný neatómový zápis.
Verzia: C23
Syntax
bool atomic_compare_exchange_weak(volatile A *object, C *expected, C desired);atomic_compare_exchange_weak(object, expected, desired) má rovnaké uloženie pri úspechu a aktualizáciu *expected pri neúspechu ako strong, ale môže vrátiť false falošne aj pri zhodných hodnotách. Operácia read-modify-write nad object zostáva atómová; zápis do expected pri zlyhaní je bežný neatómový zápis.
Je určená najmä pre opakovacie slučky, kde občasné falošné zlyhanie nemení algoritmus a môže umožniť lacnejšiu hardvérovú inštrukciu. Príklad začne s chybným expected = 3; prvé zlyhanie tam zapíše 7 a slučka napokon zmení atómovú hodnotu na 9.
Kód musí opakovať aj pri zásahoch iných vlákien a prepočítať desired, ak závisí od aktualizovaného expected. Forma bez _explicit používa memory_order_seq_cst; neplatné ukazovatele, pretek nad neatómovým expected či jediný pokus porušujú kontrakt. ABA zostáva možné. Porušenie požiadaviek na ukazovatele — vrátane neplatného ukazovateľa, nekompatibilného cieľového typu alebo nemeniteľného objektu expected — má nedefinované správanie; rovnako aj nesynchronizované dátové preteky nad expected.
C23 porovnáva obsah, teda reprezentácie hodnôt označené ukazovateľmi object a expected, nielen ich matematickú rovnosť; atómová operácia read-modify-write sa vykonáva nad object, kým expected je bežné neatómové úložisko. Súbežný nesynchronizovaný prístup k expected vytvára dátové preteky a nedefinované správanie. Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.
Príklady
#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;
}
Výsledok
9 7 1
Je určená najmä pre opakovacie slučky, kde občasné falošné zlyhanie nemení algoritmus a môže umožniť lacnejšiu hardvérovú inštrukciu. Príklad začne s chybným `expected = 3`; prvé zlyhanie tam zapíše `7` a slučka napokon zmení atómovú hodnotu na `9`.