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

CKTIS / C

atomic_compare_exchange_weak — atomická generická funkce C23

`atomic_compare_exchange_weak(object, expected, desired)` má stejné uložení při úspěchu a aktualizaci `*expected` při neúspěchu jako `strong`, ale může vrátit `false` falešně i při shodných hodnotách. Operace read-modify-write nad `object` zůstává atomická; zápis do `expected` při selhání je běžný neatomický zápis.

Verze: C23

Syntaxe

bool atomic_compare_exchange_weak(volatile A *object, C *expected, C desired);

atomic_compare_exchange_weak(object, expected, desired) má stejné uložení při úspěchu a aktualizaci *expected při neúspěchu jako strong, ale může vrátit false falešně i při shodných hodnotách. Operace read-modify-write nad object zůstává atomická; zápis do expected při selhání je běžný neatomický zápis.

Je určena hlavně pro opakovací smyčky, kde občasné falešné selhání nemění algoritmus a může umožnit levnější hardwarovou instrukci. Příklad začne s chybným expected = 3; první selhání tam zapíše 7 a smyčka nakonec změní atomickou hodnotu na 9.

Kód musí opakovat i při zásazích jiných vláken a přepočítat desired, pokud závisí na aktualizovaném expected. Forma bez _explicit používá memory_order_seq_cst; neplatné ukazatele, závod nad neatomickým expected či jediný pokus porušují kontrakt. ABA zůstává možné. 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 = 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;
}

Výsledek

9 7 1

Je určena hlavně pro opakovací smyčky, kde občasné falešné selhání nemění algoritmus a může umožnit levnější hardwarovou instrukci. Příklad začne s chybným `expected = 3`; první selhání tam zapíše `7` a smyčka nakonec změní atomickou hodnotu na `9`.

Zdroje