CKTIS / C
atomic_compare_exchange_strong — atomowa funkcja generyczna C23
`atomic_compare_exchange_strong(object, expected, desired)` z `<stdatomic.h>` atomowo porównuje wartość atomową `*object` z nieatomową wartością `*expected`. Przy równości zapisuje `desired` do obiektu i zwraca `true`; przy nierówności zapisuje bieżącą wartość obiektu do `*expected` i zwraca `false`, bez fałszywej porażki.
Wersja: C23
Składnia
bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);atomic_compare_exchange_strong(object, expected, desired) z <stdatomic.h> atomowo porównuje wartość atomową *object z nieatomową wartością *expected. Przy równości zapisuje desired do obiektu i zwraca true; przy nierówności zapisuje bieżącą wartość obiektu do *expected i zwraca false, bez fałszywej porażki.
Nadaje się do jednorazowej próby przejścia stanu, gdy kod ma osobno obsłużyć sukces i rzeczywistą niezgodność. Przykład wykonuje udaną zamianę 7→11, a następnie nieudaną próbę z oczekiwanym 7; druga próba aktualizuje expected do 11.
object musi wskazywać zgodny typ atomowy, a expected — modyfikowalny odpowiadający typ nieatomowy; nieważne wskaźniki lub wyścig na expected są błędne. Wariant bez _explicit używa memory_order_seq_cst. Porównanie samej wartości nie rozwiązuje problemu ABA i nie chroni innych współdzielonych danych bez właściwego protokołu porządku pamięci. Naruszenie wymagań wskaźników — w tym nieważny wskaźnik, niezgodny wskazywany typ albo niemodyfikowalny obiekt expected — ma niezdefiniowane zachowanie; niesynchronizowany wyścig na expected również ma niezdefiniowane zachowanie.
C23 porównuje zawartość, czyli reprezentacje wartości wskazywane przez object i expected, a nie tylko ich matematyczną równość; atomowa operacja read-modify-write dotyczy object, natomiast expected jest zwykłą pamięcią nieatomową. Równoczesny niesynchronizowany dostęp do expected tworzy wyścig danych i niezdefiniowane zachowanie. Nazwa tej funkcji generycznej może być makrem albo identyfikatorem zewnętrznym; stłumienie makra w celu wywołania rzeczywistej funkcji lub zdefiniowanie zewnętrznego identyfikatora o tej nazwie ma niezdefiniowane zachowanie.
Przykłady
#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;
}
Wynik
1 0 11 11
Nadaje się do jednorazowej próby przejścia stanu, gdy kod ma osobno obsłużyć sukces i rzeczywistą niezgodność. Przykład wykonuje udaną zamianę `7→11`, a następnie nieudaną próbę z oczekiwanym `7`; druga próba aktualizuje `expected` do `11`.