WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

atomic_compare_exchange_strong — atomare generische C23-Funktion

`atomic_compare_exchange_strong(object, expected, desired)` aus `<stdatomic.h>` vergleicht atomar das atomare `*object` mit dem nicht atomaren `*expected`. Bei Gleichheit speichert sie `desired` im Objekt und liefert `true`; andernfalls schreibt sie den aktuellen Objektwert nach `*expected` und liefert ohne fälschliches Scheitern `false`.

Version: C23

Syntax

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

atomic_compare_exchange_strong(object, expected, desired) aus <stdatomic.h> vergleicht atomar das atomare *object mit dem nicht atomaren *expected. Bei Gleichheit speichert sie desired im Objekt und liefert true; andernfalls schreibt sie den aktuellen Objektwert nach *expected und liefert ohne fälschliches Scheitern false.

Sie eignet sich für einen einmaligen Zustandsübergang mit getrennten Pfaden für Erfolg und echte Abweichung. Das Beispiel ersetzt erfolgreich 7→11 und versucht danach erneut mit Erwartung 7; der zweite Versuch scheitert und aktualisiert expected auf 11.

object muss auf einen passenden atomaren Typ zeigen, expected auf einen veränderbaren zugehörigen nicht atomaren Typ; ungültige Zeiger oder ein Datenrennen auf expected sind fehlerhaft. Die Form ohne _explicit nutzt memory_order_seq_cst. Ein reiner Wertvergleich löst weder ABA noch schützt er andere Daten ohne korrektes Speicherordnungsprotokoll. Ein Verstoß gegen die Zeigeranforderungen — einschließlich eines ungültigen Zeigers, eines inkompatiblen Zieltyps oder eines nicht änderbaren expected-Objekts — hat undefiniertes Verhalten; ein unsynchronisiertes Datenrennen auf expected ebenfalls.

C23 vergleicht den Inhalt, also die von object und expected bezeichneten Wertdarstellungen, nicht nur ihre mathematische Gleichheit; das atomare Read-Modify-Write betrifft object, während expected gewöhnlicher nicht atomarer Speicher ist. Gleichzeitiger unsynchronisierter Zugriff auf expected erzeugt ein Datenrennen und undefiniertes Verhalten. Der Name dieser generischen Funktion darf ein Makro oder ein externer Bezeichner sein; das Unterdrücken des Makros zum Aufruf einer tatsächlichen Funktion oder das Definieren eines externen Bezeichners dieses Namens hat undefiniertes Verhalten.

Beispiele

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

Ergebnis

1 0 11 11

Sie eignet sich für einen einmaligen Zustandsübergang mit getrennten Pfaden für Erfolg und echte Abweichung. Das Beispiel ersetzt erfolgreich `7→11` und versucht danach erneut mit Erwartung `7`; der zweite Versuch scheitert und aktualisiert `expected` auf `11`.

Quellen