Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

atomic_compare_exchange_strong — atómová generická funkcia C23

`atomic_compare_exchange_strong(object, expected, desired)` z `<stdatomic.h>` atómovo porovná atómové `*object` s neatómovým `*expected`. Pri zhode uloží `desired` a vráti `true`; inak zapíše aktuálnu hodnotu objektu do `*expected` a vráti `false`, bez falošného zlyhania.

Verzia: C23

Syntax

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

atomic_compare_exchange_strong(object, expected, desired) z <stdatomic.h> atómovo porovná atómové *object s neatómovým *expected. Pri zhode uloží desired a vráti true; inak zapíše aktuálnu hodnotu objektu do *expected a vráti false, bez falošného zlyhania.

Hodí sa na jediný pokus o prechod stavu s oddelenými cestami pre úspech a skutočnú nezhodu. Príklad úspešne nahradí 7→11, potom znovu očakáva 7; druhý pokus zlyhá a aktualizuje expected na 11.

object musí ukazovať na kompatibilný atómový typ a expected na zodpovedajúci meniteľný neatómový typ; neplatné ukazovatele či pretek nad expected sú chybné. Forma bez _explicit používa memory_order_seq_cst. Samotné porovnanie hodnoty nerieši ABA ani nechráni ďalšie dáta bez správneho pamäťového protokolu. Porušenie požiadaviek na ukazovatele — vrátane neplatného ukazovateľa, nekompatibilného cieľového typu alebo nemeniteľného objektu expected — má nedefinované správanie; rovnako aj nesynchronizované dátové preteky nad expected.

C23 porovnáva obsah, teda reprezentácie hodnôt označené ukazovateľmi object a expected, nielen ich matematickú rovnosť; atómová operácia read-modify-write sa vykonáva nad object, kým expected je bežné neatómové úložisko. Súbežný nesynchronizovaný prístup k expected vytvára dátové preteky a nedefinované správanie. Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.

Prí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ýsledok

1 0 11 11

Hodí sa na jediný pokus o prechod stavu s oddelenými cestami pre úspech a skutočnú nezhodu. Príklad úspešne nahradí `7→11`, potom znovu očakáva `7`; druhý pokus zlyhá a aktualizuje `expected` na `11`.

Zdroje