Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

atomic_compare_exchange_strong — atomska generična funkcija C23

`atomic_compare_exchange_strong(object, expected, desired)` iz `<stdatomic.h>` atomsko primerja atomski `*object` z neatomskim `*expected`. Ob ujemanju shrani `desired` in vrne `true`; sicer zapiše trenutno vrednost v `*expected` in vrne `false`, brez lažnega neuspeha.

Različica: C23

Sintaksa

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

atomic_compare_exchange_strong(object, expected, desired) iz <stdatomic.h> atomsko primerja atomski *object z neatomskim *expected. Ob ujemanju shrani desired in vrne true; sicer zapiše trenutno vrednost v *expected in vrne false, brez lažnega neuspeha.

Primerna je za en poskus prehoda stanja z ločenima potema za uspeh in resnično neujemanje. Primer uspešno zamenja 7→11, nato spet pričakuje 7; drugi poskus spodleti in posodobi expected na 11.

object mora kazati na združljiv atomski tip, expected pa na ustrezen spremenljiv neatomski tip; neveljavni kazalci ali tekma nad expected so napačni. Oblika brez _explicit uporablja memory_order_seq_cst. Primerjava same vrednosti ne reši ABA niti ne zaščiti drugih podatkov brez pravilnega pomnilniškega protokola. Kršitev zahtev za kazalce — vključno z neveljavnim kazalcem, nezdružljivim kazanim tipom ali nespremenljivim objektom expected — ima nedoločeno vedenje; enako velja za neusklajeno podatkovno tekmo nad expected.

C23 primerja vsebino, torej predstavitvi vrednosti, ki ju označujeta object in expected, ne le njune matematične enakosti; atomska operacija read-modify-write se izvede nad object, medtem ko je expected navadna neatomska shramba. Sočasen neusklajen dostop do expected povzroči podatkovno tekmo in nedoločeno vedenje. Ime te generične funkcije je lahko makro ali zunanji identifikator; zatiranje makra za klic dejanske funkcije ali definiranje zunanjega identifikatorja s tem imenom ima nedoločeno vedenje.

Primeri

#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;
}

Rezultat

1 0 11 11

Primerna je za en poskus prehoda stanja z ločenima potema za uspeh in resnično neujemanje. Primer uspešno zamenja `7→11`, nato spet pričakuje `7`; drugi poskus spodleti in posodobi `expected` na `11`.

Viri