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

CKTIS / C

atomic_load — atomická generická funkce C23

`atomic_load(object)` atomicky vrátí hodnotu zadaného atomického objektu. Forma bez `_explicit` odpovídá `atomic_load_explicit(..., memory_order_seq_cst)`; `volatile` ukazatele zachovává sémantiku registrů zařízení.

Verze: C23

Syntaxe

C atomic_load(const volatile A *object);

atomic_load(object) atomicky vrátí hodnotu zadaného atomického objektu. Forma bez _explicit odpovídá atomic_load_explicit(..., memory_order_seq_cst); volatile ukazatele zachovává sémantiku registrů zařízení.

Load poskytne soudržný snímek čítače či příznaku bez závodu s atomickými zapisujícími. Příklad zvýší 41 na 42; oba skutečné loady, sekvenčně konzistentní i relaxed, poté vrátí 42.

atomic_load_explicit nesmí použít memory_order_release ani memory_order_acq_rel; relaxed stále zaručuje atomicitu a pořadí modifikací objektu, ale nezveřejňuje další data. Objekt musí být inicializován a ukazatel platný; operace nemusí být lock-free.

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 counter = 41;
    atomic_fetch_add(&counter, 1);
    int sequential = atomic_load(&counter);
    int relaxed = atomic_load_explicit(&counter, memory_order_relaxed);
    printf("%d %d\n", sequential, relaxed);
    return 0;
}

Výsledek

42 42

Load poskytne soudržný snímek čítače či příznaku bez závodu s atomickými zapisujícími. Příklad zvýší `41` na `42`; oba skutečné loady, sekvenčně konzistentní i relaxed, poté vrátí `42`.

Zdroje