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

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

Fontes