Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

atomic_init — función genérica atómica de C23

`atomic_init(obj, value)` de `<stdatomic.h>` inicializa el objeto atómico apuntado con `value`, incluido cualquier estado adicional de la implementación, y no devuelve valor. Si el almacenamiento no tiene tipo declarado, la llamada le da el tipo efectivo atómico `A`.

Versión: C23

Sintaxis

void atomic_init(volatile A *obj, C value);

atomic_init(obj, value) de <stdatomic.h> inicializa el objeto atómico apuntado con value, incluido cualquier estado adicional de la implementación, y no devuelve valor. Si el almacenamiento no tiene tipo declarado, la llamada le da el tipo efectivo atómico A.

Sirve para dejar un objeto atómico automático o asignado en estado válido antes de publicar su dirección a otros hilos. El ejemplo inicializa realmente un atomic_int con 42 y después lo lee mediante atomic_load.

atomic_init no sincroniza: cualquier acceso concurrente durante la inicialización, incluso atómico, crea una carrera de datos. Una escritura no atómica en cualquier byte, incluso mediante memcpy o memset, deja la representación indeterminada. Llamarla desde un manejador de señal tiene comportamiento indefinido salvo que la señal proceda de abort o raise; la inicialización predeterminada deja válidos los objetos estáticos y de hilo distintos de atomic_flag.

El nombre de esta función genérica puede ser una macro o un identificador externo; suprimir la macro para llamar a una función real o definir un identificador externo con ese nombre tiene comportamiento indefinido.

Ejemplos

#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

Sirve para dejar un objeto atómico automático o asignado en estado válido antes de publicar su dirección a otros hilos. El ejemplo inicializa realmente un `atomic_int` con `42` y después lo lee mediante `atomic_load`.

Fuentes