Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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`.

Zdroje