Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atomic_thread_fence — funzione fence C23

`atomic_thread_fence(order)` stabilisce una barriera di memoria senza leggere o scrivere uno specifico oggetto atomico. Relaxed non ha effetto; consume/acquire crea una fence acquire, release una release, acq_rel entrambe e seq_cst partecipa anche all’ordine sequenzialmente consistente. Non restituisce valori.

Versione: C23

Sintassi

void atomic_thread_fence(memory_order order);

atomic_thread_fence(order) stabilisce una barriera di memoria senza leggere o scrivere uno specifico oggetto atomico. Relaxed non ha effetto; consume/acquire crea una fence acquire, release una release, acq_rel entrambe e seq_cst partecipa anche all’ordine sequenzialmente consistente. Non restituisce valori.

Una fence può collegare dati ordinari tramite un marcatore atomico separato. Nell’esempio il produttore scrive payload = 42, esegue una fence release e uno store relaxed in ready; il consumatore legge quello store con load relaxed, esegue una fence acquire e stampa 42 senza race.

Una fence da sola non trasferisce valori né sincronizza thread: serve la catena C23 tra modifica atomica e load che legge quel valore, o la corrispondente variante fence-operazione. Se il load non legge lo store giusto, payload non è protetto. Una fence relaxed non risolve nulla; seq_cst superfluo può costare più della coppia acquire/release.

Esempi

#include <stdatomic.h>
#include <stdio.h>
#include <threads.h>

static int payload;
static atomic_int ready = 0;

static int writer(void *unused) {
    (void)unused;
    payload = 42;
    atomic_thread_fence(memory_order_release);
    atomic_store_explicit(&ready, 1, memory_order_relaxed);
    return 0;
}

static int reader(void *unused) {
    (void)unused;
    while (!atomic_load_explicit(&ready, memory_order_relaxed)) thrd_yield();
    atomic_thread_fence(memory_order_acquire);
    printf("%d\n", payload);
    return 0;
}

int main(void) {
    thrd_t producer, consumer;
    if (thrd_create(&consumer, reader, NULL) != thrd_success) return 1;
    if (thrd_create(&producer, writer, NULL) != thrd_success) return 1;
    thrd_join(producer, NULL);
    thrd_join(consumer, NULL);
    return 0;
}

Risultato

42

Una fence può collegare dati ordinari tramite un marcatore atomico separato. Nell’esempio il produttore scrive `payload = 42`, esegue una fence release e uno store relaxed in `ready`; il consumatore legge quello store con load relaxed, esegue una fence acquire e stampa `42` senza race.

Fonti