Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

atomic_load — função genérica atómica C23

`atomic_load(object)` devolve atomicamente o valor do objeto atómico apontado. A forma sem `_explicit` equivale a `atomic_load_explicit(..., memory_order_seq_cst)`; o `volatile` do ponteiro preserva a semântica de registos de dispositivo.

Versão: C23

Sintaxe

C atomic_load(const volatile A *object);

atomic_load(object) devolve atomicamente o valor do objeto atómico apontado. A forma sem _explicit equivale a atomic_load_explicit(..., memory_order_seq_cst); o volatile do ponteiro preserva a semântica de registos de dispositivo.

Um load obtém uma imagem coerente de contador ou flag sem corrida com escritores atómicos. O exemplo incrementa 41 para 42; depois, ambas as leituras reais, sequencialmente consistente e relaxed, devolvem 42.

atomic_load_explicit não pode usar memory_order_release nem memory_order_acq_rel; relaxed ainda garante atomicidade e ordem de modificação do objeto, mas não publica outros dados. O objeto tem de estar inicializado e o ponteiro válido; a operação pode não ser lock-free.

O nome desta função genérica pode ser uma macro ou um identificador externo; suprimir a macro para chamar uma função real ou definir um identificador externo com esse nome tem comportamento indefinido.

Exemplos

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

Resultado

42 42

Um load obtém uma imagem coerente de contador ou flag sem corrida com escritores atómicos. O exemplo incrementa `41` para `42`; depois, ambas as leituras reais, sequencialmente consistente e relaxed, devolvem `42`.

Fontes