WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen