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

CKTIS / C

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

`atomic_store(object, desired)` substitui atomicamente o valor do objeto apontado por `desired` e não devolve valor. A forma sem `_explicit` usa `memory_order_seq_cst`; é uma escrita, não uma read-modify-write.

Versão: C23

Sintaxe

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

atomic_store(object, desired) substitui atomicamente o valor do objeto apontado por desired e não devolve valor. A forma sem _explicit usa memory_order_seq_cst; é uma escrita, não uma read-modify-write.

Um store release publica estado concluído que o consumidor lê com load acquire no mesmo átomo. O exemplo guarda 17 e depois 23; a leitura acquire real observa o valor final 23.

atomic_store_explicit não pode receber memory_order_consume, memory_order_acquire ou memory_order_acq_rel; relaxed escreve atomicamente mas não publica escritas comuns anteriores. O objeto tem de estar inicializado e o ponteiro válido; a implementação pode usar bloqueio.

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

Resultado

23

Um store release publica estado concluído que o consumidor lê com load acquire no mesmo átomo. O exemplo guarda `17` e depois `23`; a leitura acquire real observa o valor final `23`.

Fontes