Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_compare_exchange_weak — funzione generica atomica C23

`atomic_compare_exchange_weak(object, expected, desired)` ha la stessa scrittura al successo e lo stesso aggiornamento di `*expected` al fallimento di `strong`, ma può restituire `false` in modo spurio anche con valori uguali. La read-modify-write su `object` resta atomica; la scrittura in `expected` al fallimento è una normale scrittura non atomica.

Versione: C23

Sintassi

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

atomic_compare_exchange_weak(object, expected, desired) ha la stessa scrittura al successo e lo stesso aggiornamento di *expected al fallimento di strong, ma può restituire false in modo spurio anche con valori uguali. La read-modify-write su object resta atomica; la scrittura in expected al fallimento è una normale scrittura non atomica.

È pensata soprattutto per cicli di tentativi dove un fallimento spurio occasionale non cambia l’algoritmo e può consentire un’istruzione hardware più economica. L’esempio parte da expected = 3 errato; il primo fallimento vi scrive 7 e il ciclo infine porta l’atomico a 9.

Il codice deve riprovare durante interferenze di altri thread e ricalcolare desired se dipende dall’expected aggiornato. La forma senza _explicit usa memory_order_seq_cst; puntatori non validi, race su expected non atomico o un solo tentativo violano il contratto. ABA resta possibile. 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 = 3;
    int failures = 0;

    while (!atomic_compare_exchange_weak(&value, &expected, 9)) {
        ++failures;
    }
    printf("%d %d %d\n", atomic_load(&value), expected, failures >= 1);
    return 0;
}

Risultato

9 7 1

È pensata soprattutto per cicli di tentativi dove un fallimento spurio occasionale non cambia l’algoritmo e può consentire un’istruzione hardware più economica. L’esempio parte da `expected = 3` errato; il primo fallimento vi scrive `7` e il ciclo infine porta l’atomico a `9`.

Fonti