CKTIS / C
atomic_init — função genérica atómica C23
`atomic_init(obj, value)` de `<stdatomic.h>` inicializa o objeto atómico apontado com `value`, incluindo estado adicional exigido pela implementação, e não devolve valor. Se o armazenamento não tiver tipo declarado, a chamada atribui-lhe o tipo efetivo atómico `A`.
Versão: C23
Sintaxe
void atomic_init(volatile A *obj, C value);atomic_init(obj, value) de <stdatomic.h> inicializa o objeto atómico apontado com value, incluindo estado adicional exigido pela implementação, e não devolve valor. Se o armazenamento não tiver tipo declarado, a chamada atribui-lhe o tipo efetivo atómico A.
Usa-a para colocar um objeto atómico automático ou alocado num estado válido antes de publicar o endereço a outras threads. O exemplo inicializa realmente um atomic_int com 42 e depois lê-o através de atomic_load.
atomic_init não sincroniza: qualquer acesso concorrente durante a inicialização, mesmo atómico, cria uma corrida de dados. Uma escrita não atómica em qualquer byte, incluindo por memcpy ou memset, torna a representação indeterminada. Chamá-la num tratador de sinal tem comportamento indefinido salvo se o sinal resultar de abort ou raise; a inicialização predefinida deixa válidos os objetos estáticos e de duração de thread que não sejam atomic_flag.
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 value;
atomic_init(&value, 42);
printf("%d\n", atomic_load(&value));
return 0;
}
Resultado
42
Usa-a para colocar um objeto atómico automático ou alocado num estado válido antes de publicar o endereço a outras threads. O exemplo inicializa realmente um `atomic_int` com `42` e depois lê-o através de `atomic_load`.