CKTIS / C
atomic_compare_exchange_strong — atomická generická funkce C23
`atomic_compare_exchange_strong(object, expected, desired)` z `<stdatomic.h>` atomicky porovná atomické `*object` s neatomickým `*expected`. Při shodě uloží `desired` a vrátí `true`; jinak zapíše aktuální hodnotu objektu do `*expected` a vrátí `false`, bez falešného selhání.
Verze: C23
Syntaxe
bool atomic_compare_exchange_strong(volatile A *object, C *expected, C desired);atomic_compare_exchange_strong(object, expected, desired) z <stdatomic.h> atomicky porovná atomické *object s neatomickým *expected. Při shodě uloží desired a vrátí true; jinak zapíše aktuální hodnotu objektu do *expected a vrátí false, bez falešného selhání.
Hodí se pro jediný pokus o přechod stavu s oddělenými cestami pro úspěch a skutečnou neshodu. Příklad úspěšně nahradí 7→11, potom znovu očekává 7; druhý pokus selže a aktualizuje expected na 11.
object musí ukazovat na kompatibilní atomický typ a expected na odpovídající měnitelný neatomický typ; neplatné ukazatele či závod nad expected jsou chybné. Forma bez _explicit používá memory_order_seq_cst. Samotné porovnání hodnoty neřeší ABA ani nechrání další data bez správného paměťového protokolu. Porušení požadavků na ukazatele — včetně neplatného ukazatele, nekompatibilního cílového typu nebo neměnitelného objektu expected — má nedefinované chování; stejně tak nesynchronizovaný datový závod nad expected.
C23 porovnává obsah, tedy reprezentace hodnot označené ukazateli object a expected, nikoli jen jejich matematickou rovnost; atomická operace read-modify-write se provádí nad object, zatímco expected je běžné neatomické úložiště. Souběžný nesynchronizovaný přístup k expected vytváří datový závod a nedefinované chování. Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.
Pří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ýsledek
1 0 11 11
Hodí se pro jediný pokus o přechod stavu s oddělenými cestami pro úspěch a skutečnou neshodu. Příklad úspěšně nahradí `7→11`, potom znovu očekává `7`; druhý pokus selže a aktualizuje `expected` na `11`.