CKTIS / C
atomic_compare_exchange_weak — atomowa funkcja generyczna C23
`atomic_compare_exchange_weak(object, expected, desired)` ma ten sam zapis sukcesu i aktualizację `*expected` przy porażce co wariant `strong`, ale może zwrócić `false` fałszywie nawet przy równych wartościach. Operacja read-modify-write na `object` pozostaje atomowa; zapis do `expected` przy porażce jest zwykłym zapisem nieatomowym.
Wersja: C23
Składnia
bool atomic_compare_exchange_weak(volatile A *object, C *expected, C desired);atomic_compare_exchange_weak(object, expected, desired) ma ten sam zapis sukcesu i aktualizację *expected przy porażce co wariant strong, ale może zwrócić false fałszywie nawet przy równych wartościach. Operacja read-modify-write na object pozostaje atomowa; zapis do expected przy porażce jest zwykłym zapisem nieatomowym.
Jest przeznaczona głównie do pętli ponawiających, gdzie okazjonalna fałszywa porażka nie zmienia algorytmu i może pozwolić na tańszą instrukcję sprzętową. Przykład zaczyna z błędnym expected = 3; pierwsza porażka wpisuje tam 7, a pętla ostatecznie zmienia atom na 9.
Kod musi ponawiać także wtedy, gdy inny wątek zmienia obiekt, i ponownie obliczać desired, jeśli zależy on od zaktualizowanego expected. Wariant bez _explicit używa memory_order_seq_cst; błędne wskaźniki, wyścig na nieatomowym expected i założenie, że jedna próba wystarczy, łamią kontrakt. ABA pozostaje możliwe. 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 = 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;
}
Wynik
9 7 1
Jest przeznaczona głównie do pętli ponawiających, gdzie okazjonalna fałszywa porażka nie zmienia algorytmu i może pozwolić na tańszą instrukcję sprzętową. Przykład zaczyna z błędnym `expected = 3`; pierwsza porażka wpisuje tam `7`, a pętla ostatecznie zmienia atom na `9`.