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