CKTIS / C
atomic_compare_exchange_strong — atómová generická funkcia C23
`atomic_compare_exchange_strong(object, expected, desired)` z `<stdatomic.h>` atómovo porovná atómové `*object` s neatómovým `*expected`. Pri zhode uloží `desired` a vráti `true`; inak zapíše aktuálnu hodnotu objektu do `*expected` a vráti `false`, bez falošného zlyhania.
Verzia: C23
Syntax
bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);atomic_compare_exchange_strong(object, expected, desired) z <stdatomic.h> atómovo porovná atómové *object s neatómovým *expected. Pri zhode uloží desired a vráti true; inak zapíše aktuálnu hodnotu objektu do *expected a vráti false, bez falošného zlyhania.
Hodí sa na jediný pokus o prechod stavu s oddelenými cestami pre úspech a skutočnú nezhodu. Príklad úspešne nahradí 7→11, potom znovu očakáva 7; druhý pokus zlyhá a aktualizuje expected na 11.
object musí ukazovať na kompatibilný atómový typ a expected na zodpovedajúci meniteľný neatómový typ; neplatné ukazovatele či pretek nad expected sú chybné. Forma bez _explicit používa memory_order_seq_cst. Samotné porovnanie hodnoty nerieši ABA ani nechráni ďalšie dáta bez správneho pamäťového protokolu. 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 = 7;
bool replaced = atomic_compare_exchange_strong(&value, &expected, 11);
expected = 7;
bool rejected = atomic_compare_exchange_strong(&value, &expected, 13);
printf("%d %d %d %d\n", replaced, rejected, atomic_load(&value), expected);
return 0;
}
Výsledok
1 0 11 11
Hodí sa na jediný pokus o prechod stavu s oddelenými cestami pre úspech a skutočnú nezhodu. Príklad úspešne nahradí `7→11`, potom znovu očakáva `7`; druhý pokus zlyhá a aktualizuje `expected` na `11`.