CKTIS / C
atomic_compare_exchange_strong — atomaire generieke C23-functie
`atomic_compare_exchange_strong(object, expected, desired)` uit `<stdatomic.h>` vergelijkt atomair het atomaire `*object` met het niet-atomaire `*expected`. Bij gelijkheid slaat het `desired` op en retourneert `true`; anders schrijft het de huidige waarde naar `*expected` en retourneert zonder spurieus falen `false`.
Versie: C23
Syntax
bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);atomic_compare_exchange_strong(object, expected, desired) uit <stdatomic.h> vergelijkt atomair het atomaire *object met het niet-atomaire *expected. Bij gelijkheid slaat het desired op en retourneert true; anders schrijft het de huidige waarde naar *expected en retourneert zonder spurieus falen false.
Gebruik dit voor één poging tot een toestandsovergang met aparte paden voor succes en een echte afwijking. Het voorbeeld vervangt succesvol 7→11 en verwacht daarna opnieuw 7; de tweede poging faalt en werkt expected bij naar 11.
object moet naar een compatibel atomair type wijzen en expected naar het overeenkomstige wijzigbare niet-atomaire type; ongeldige pointers of een race op expected zijn fout. De vorm zonder _explicit gebruikt memory_order_seq_cst. Alleen de waarde vergelijken lost ABA niet op en beschermt andere data niet zonder correct geheugenprotocol. 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 = 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;
}
Resultaat
1 0 11 11
Gebruik dit voor één poging tot een toestandsovergang met aparte paden voor succes en een echte afwijking. Het voorbeeld vervangt succesvol `7→11` en verwacht daarna opnieuw `7`; de tweede poging faalt en werkt `expected` bij naar `11`.