KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_store — atomaire generieke C23-functie

`atomic_store(object, desired)` vervangt atomair de waarde van het aangewezen object door `desired` en retourneert niets. De vorm zonder `_explicit` gebruikt `memory_order_seq_cst`; dit is een schrijfbewerking, geen read-modify-write.

Versie: C23

Syntax

void atomic_store(volatile A *object, C desired);

atomic_store(object, desired) vervangt atomair de waarde van het aangewezen object door desired en retourneert niets. De vorm zonder _explicit gebruikt memory_order_seq_cst; dit is een schrijfbewerking, geen read-modify-write.

Een release-store publiceert voltooide toestand die een consument met een acquire-load uit hetzelfde atomaire object leest. Het voorbeeld schrijft 17 en daarna 23; de echte acquire-load ziet de eindwaarde 23.

atomic_store_explicit mag geen memory_order_consume, memory_order_acquire of memory_order_acq_rel krijgen; relaxed schrijft atomair maar publiceert eerdere gewone schrijfbewerkingen niet. Object en pointer moeten geldig zijn; de implementatie kan een slot gebruiken.

De naam van deze generieke functie kan een macro of een externe identifier zijn; de macro onderdrukken om een echte functie aan te roepen, of een externe identifier met die naam definiëren, heeft ongedefinieerd gedrag.

Voorbeelden

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

int main(void) {
    atomic_int state = 0;
    atomic_store(&state, 17);
    atomic_store_explicit(&state, 23, memory_order_release);
    printf("%d\n", atomic_load_explicit(&state, memory_order_acquire));
    return 0;
}

Resultaat

23

Een release-store publiceert voltooide toestand die een consument met een acquire-load uit hetzelfde atomaire object leest. Het voorbeeld schrijft `17` en daarna `23`; de echte acquire-load ziet de eindwaarde `23`.

Bronnen