Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

atomic_load — atómová generická funkcia C23

`atomic_load(object)` atómovo vráti hodnotu zadaného atómového objektu. Forma bez `_explicit` zodpovedá `atomic_load_explicit(..., memory_order_seq_cst)`; `volatile` ukazovateľa zachováva sémantiku registrov zariadenia.

Verzia: C23

Syntax

C atomic_load(const volatile A *object);

atomic_load(object) atómovo vráti hodnotu zadaného atómového objektu. Forma bez _explicit zodpovedá atomic_load_explicit(..., memory_order_seq_cst); volatile ukazovateľa zachováva sémantiku registrov zariadenia.

Load poskytne súdržnú snímku počítadla či príznaku bez pretekov s atómovými zapisujúcimi. Príklad zvýši 41 na 42; oba skutočné loady, sekvenčne konzistentný aj relaxed, potom vrátia 42.

atomic_load_explicit nesmie použiť memory_order_release ani memory_order_acq_rel; relaxed stále zaručuje atómovosť a poradie modifikácií objektu, ale nezverejňuje ďalšie dáta. Objekt musí byť inicializovaný a ukazovateľ platný; operácia nemusí byť lock-free.

Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.

Prí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ýsledok

42 42

Load poskytne súdržnú snímku počítadla či príznaku bez pretekov s atómovými zapisujúcimi. Príklad zvýši `41` na `42`; oba skutočné loady, sekvenčne konzistentný aj relaxed, potom vrátia `42`.

Zdroje