CKTIS / C
atomic_compare_exchange_strong — atomska generička funkcija C23
`atomic_compare_exchange_strong(object, expected, desired)` iz `<stdatomic.h>` atomski uspoređuje atomski `*object` s neatomskim `*expected`. Ako su jednaki, sprema `desired` i vraća `true`; inače zapisuje trenutačnu vrijednost u `*expected` i vraća `false`, bez lažnog neuspjeha.
Verzija: C23
Sintaksa
bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);atomic_compare_exchange_strong(object, expected, desired) iz <stdatomic.h> atomski uspoređuje atomski *object s neatomskim *expected. Ako su jednaki, sprema desired i vraća true; inače zapisuje trenutačnu vrijednost u *expected i vraća false, bez lažnog neuspjeha.
Služi jednom pokušaju prijelaza stanja s odvojenim putovima za uspjeh i stvarno nepodudaranje. Primjer uspješno zamjenjuje 7→11, zatim ponovno očekuje 7; drugi pokušaj ne uspijeva i ažurira expected na 11.
object mora pokazivati na kompatibilan atomski tip, a expected na odgovarajući promjenjivi neatomski tip; nevaljani pokazivači ili utrka nad expected pogrešni su. Oblik bez _explicit koristi memory_order_seq_cst. Sama usporedba vrijednosti ne rješava ABA niti štiti druge podatke bez ispravnog memorijskog protokola. Kršenje zahtjeva za pokazivače — uključujući nevaljan pokazivač, nekompatibilan pokazivani tip ili nepromjenjiv objekt expected — ima nedefinirano ponašanje; isto vrijedi za nesinkroniziranu utrku nad expected.
C23 uspoređuje sadržaj, odnosno prikaze vrijednosti na koje upućuju object i expected, a ne samo njihovu matematičku jednakost; atomska operacija read-modify-write izvodi se nad object, dok je expected obična neatomska pohrana. Istodobni nesinkronizirani pristup objektu expected uzrokuje utrku podataka i nedefinirano ponašanje. Naziv ove generičke funkcije može biti makro ili vanjski identifikator; potiskivanje makroa radi poziva stvarne funkcije ili definiranje vanjskog identifikatora tog naziva ima nedefinirano ponašanje.
Primjeri
#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;
}
Rezultat
1 0 11 11
Služi jednom pokušaju prijelaza stanja s odvojenim putovima za uspjeh i stvarno nepodudaranje. Primjer uspješno zamjenjuje `7→11`, zatim ponovno očekuje `7`; drugi pokušaj ne uspijeva i ažurira `expected` na `11`.