CKTIS / C
atomic_init — atomska generička funkcija C23
`atomic_init(obj, value)` iz `<stdatomic.h>` inicijalizira zadani atomski objekt vrijednošću `value`, uključujući dodatno stanje implementacije, i ne vraća vrijednost. Ako pohrana nema deklariran tip, poziv joj daje efektivni atomski tip `A`.
Verzija: C23
Sintaksa
void atomic_init(volatile A *obj, C value);atomic_init(obj, value) iz <stdatomic.h> inicijalizira zadani atomski objekt vrijednošću value, uključujući dodatno stanje implementacije, i ne vraća vrijednost. Ako pohrana nema deklariran tip, poziv joj daje efektivni atomski tip A.
Koristi se da automatski ili alocirani atomski objekt dobije valjano stanje prije objave adrese drugim dretvama. Primjer doista inicijalizira atomic_int na 42, a zatim ga čita pomoću atomic_load.
atomic_init ne sinkronizira: svaki istodobni pristup tijekom inicijalizacije, čak i atomski, stvara utrku podataka. Neatomski zapis u bilo koji bajt, pa i preko memcpy ili memset, čini prikaz neodređenim. Poziv iz rukovatelja signalom ima nedefinirano ponašanje osim za signal iz abort ili raise; zadana inicijalizacija daje valjano stanje statičkim i dretvenim objektima osim atomic_flag.
Naziv ove generičke funkcije može biti makro ili vanjski identifikator; potiskivanje makroa radi poziva stvarne funkcije ili definiranje vanjskog identifikatora tog naziva ima nedefinirano ponašanje.
Primjeri
#include <stdatomic.h>
#include <stdio.h>
int main(void) {
atomic_int value;
atomic_init(&value, 42);
printf("%d\n", atomic_load(&value));
return 0;
}
Rezultat
42
Koristi se da automatski ili alocirani atomski objekt dobije valjano stanje prije objave adrese drugim dretvama. Primjer doista inicijalizira `atomic_int` na `42`, a zatim ga čita pomoću `atomic_load`.