CKTIS / C
atomic_thread_fence — C23-Fence-Funktion
`atomic_thread_fence(order)` errichtet eine Speicherbarriere, ohne ein bestimmtes Atom zu lesen oder zu schreiben. Relaxed hat keinen Effekt; consume/acquire ergibt eine Acquire-, release eine Release-, acq_rel beide und seq_cst zusätzlich eine sequentiell konsistente Fence. Sie liefert keinen Wert.
Version: C23
Syntax
void atomic_thread_fence(memory_order order);atomic_thread_fence(order) errichtet eine Speicherbarriere, ohne ein bestimmtes Atom zu lesen oder zu schreiben. Relaxed hat keinen Effekt; consume/acquire ergibt eine Acquire-, release eine Release-, acq_rel beide und seq_cst zusätzlich eine sequentiell konsistente Fence. Sie liefert keinen Wert.
Eine Fence kann gewöhnliche Daten über einen getrennten atomaren Marker verbinden. Im Beispiel schreibt der Produzent payload = 42, führt eine Release-Fence und einen relaxed Store nach ready aus; der Verbraucher liest genau diesen Store relaxed, führt eine Acquire-Fence aus und gibt sicher 42 aus.
Eine Fence allein überträgt keinen Wert und synchronisiert keine Threads: Erforderlich ist die von C23 definierte Kette über atomare Modifikation und einen Load, der diesen Wert liest (oder die entsprechende Fence-Operation-Variante). Liest der Load nicht den richtigen Store, ist payload ungeschützt. Eine relaxed Fence repariert nichts; unnötiges seq_cst kann mehr kosten als acquire/release.
Beispiele
#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;
}
Ergebnis
42
Eine Fence kann gewöhnliche Daten über einen getrennten atomaren Marker verbinden. Im Beispiel schreibt der Produzent `payload = 42`, führt eine Release-Fence und einen relaxed Store nach `ready` aus; der Verbraucher liest genau diesen Store relaxed, führt eine Acquire-Fence aus und gibt sicher `42` aus.