Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

atomic_store — atomická generická funkce C23

`atomic_store(object, desired)` atomicky nahradí hodnotu zadaného objektu hodnotou `desired` a nic nevrací. Forma bez `_explicit` používá `memory_order_seq_cst`; jde o zápis, nikoli read-modify-write.

Verze: C23

Syntaxe

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

atomic_store(object, desired) atomicky nahradí hodnotu zadaného objektu hodnotou desired a nic nevrací. Forma bez _explicit používá memory_order_seq_cst; jde o zápis, nikoli read-modify-write.

Release store zveřejní hotový stav, který spotřebitel načte acquire loadem ze stejného atomu. Příklad uloží 17 a potom 23; skutečný acquire load pozoruje konečnou hodnotu 23.

atomic_store_explicit nesmí dostat memory_order_consume, memory_order_acquire ani memory_order_acq_rel; relaxed zapisuje atomicky, ale nezveřejní předchozí běžné zápisy. Objekt musí být inicializován a ukazatel platný; implementace může použít zámek.

Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.

Příklady

#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;
}

Výsledek

23

Release store zveřejní hotový stav, který spotřebitel načte acquire loadem ze stejného atomu. Příklad uloží `17` a potom `23`; skutečný acquire load pozoruje konečnou hodnotu `23`.

Zdroje