Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_compare_exchange_strong — funzione generica atomica C23

`atomic_compare_exchange_strong(object, expected, desired)` di `<stdatomic.h>` confronta atomicamente l’atomico `*object` con il non atomico `*expected`. Se uguali memorizza `desired` e restituisce `true`; altrimenti scrive il valore corrente in `*expected` e restituisce `false`, senza fallimenti spuri.

Versione: C23

Sintassi

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

atomic_compare_exchange_strong(object, expected, desired) di <stdatomic.h> confronta atomicamente l’atomico *object con il non atomico *expected. Se uguali memorizza desired e restituisce true; altrimenti scrive il valore corrente in *expected e restituisce false, senza fallimenti spuri.

Serve a un singolo tentativo di transizione di stato con percorsi distinti per successo e vera differenza. L’esempio sostituisce con successo 7→11, poi riprova aspettando 7; il secondo tentativo fallisce e aggiorna expected a 11.

object deve puntare a un tipo atomico compatibile e expected al corrispondente tipo non atomico modificabile; puntatori non validi o una race su expected sono errori. La forma senza _explicit usa memory_order_seq_cst. Il solo confronto del valore non risolve ABA né protegge altri dati senza un corretto protocollo di memoria. Violare i requisiti dei puntatori — incluso un puntatore non valido, un tipo puntato incompatibile o un oggetto expected non modificabile — ha comportamento indefinito; lo stesso vale per una data race non sincronizzata su expected.

C23 confronta il contenuto, cioè le rappresentazioni dei valori designate da object ed expected, non soltanto la loro uguaglianza matematica; la read-modify-write atomica riguarda object, mentre expected è memoria ordinaria non atomica. L’accesso concorrente non sincronizzato a expected crea una data race e comportamento indefinito. Il nome di questa funzione generica può essere una macro o un identificatore esterno; sopprimere la macro per chiamare una funzione reale o definire un identificatore esterno con quel nome ha comportamento indefinito.

Esempi

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

Risultato

1 0 11 11

Serve a un singolo tentativo di transizione di stato con percorsi distinti per successo e vera differenza. L’esempio sostituisce con successo `7→11`, poi riprova aspettando `7`; il secondo tentativo fallisce e aggiorna `expected` a `11`.

Fonti