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`.