KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_compare_exchange_strong — atomaire generieke C23-functie

`atomic_compare_exchange_strong(object, expected, desired)` uit `<stdatomic.h>` vergelijkt atomair het atomaire `*object` met het niet-atomaire `*expected`. Bij gelijkheid slaat het `desired` op en retourneert `true`; anders schrijft het de huidige waarde naar `*expected` en retourneert zonder spurieus falen `false`.

Versie: C23

Syntax

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

atomic_compare_exchange_strong(object, expected, desired) uit <stdatomic.h> vergelijkt atomair het atomaire *object met het niet-atomaire *expected. Bij gelijkheid slaat het desired op en retourneert true; anders schrijft het de huidige waarde naar *expected en retourneert zonder spurieus falen false.

Gebruik dit voor één poging tot een toestandsovergang met aparte paden voor succes en een echte afwijking. Het voorbeeld vervangt succesvol 7→11 en verwacht daarna opnieuw 7; de tweede poging faalt en werkt expected bij naar 11.

object moet naar een compatibel atomair type wijzen en expected naar het overeenkomstige wijzigbare niet-atomaire type; ongeldige pointers of een race op expected zijn fout. De vorm zonder _explicit gebruikt memory_order_seq_cst. Alleen de waarde vergelijken lost ABA niet op en beschermt andere data niet zonder correct geheugenprotocol. Schending van de pointervereisten — waaronder een ongeldige pointer, een incompatibel aangewezen type of een niet-wijzigbaar expected-object — heeft ongedefinieerd gedrag; een ongesynchroniseerde race op expected eveneens.

C23 vergelijkt de inhoud, dus de waarderepresentaties die door object en expected worden aangewezen, en niet alleen hun wiskundige gelijkheid; de atomaire read-modify-write betreft object, terwijl expected gewone niet-atomaire opslag is. Gelijktijdige ongesynchroniseerde toegang tot expected veroorzaakt een data race en ongedefinieerd gedrag. De naam van deze generieke functie kan een macro of een externe identifier zijn; de macro onderdrukken om een echte functie aan te roepen, of een externe identifier met die naam definiëren, heeft ongedefinieerd gedrag.

Voorbeelden

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

Resultaat

1 0 11 11

Gebruik dit voor één poging tot een toestandsovergang met aparte paden voor succes en een echte afwijking. Het voorbeeld vervangt succesvol `7→11` en verwacht daarna opnieuw `7`; de tweede poging faalt en werkt `expected` bij naar `11`.

Bronnen