CKTIS / C
atomic_init — atómová generická funkcia C23
`atomic_init(obj, value)` z `<stdatomic.h>` inicializuje zadaný atómový objekt hodnotou `value`, vrátane dodatočného stavu implementácie, a nič nevracia. Ak úložisko nemá deklarovaný typ, volanie mu dá efektívny atómový typ `A`.
Verzia: C23
Syntax
void atomic_init(volatile A *obj, C value);atomic_init(obj, value) z <stdatomic.h> inicializuje zadaný atómový objekt hodnotou value, vrátane dodatočného stavu implementácie, a nič nevracia. Ak úložisko nemá deklarovaný typ, volanie mu dá efektívny atómový typ A.
Použite ju na uvedenie automatického alebo alokovaného atómového objektu do platného stavu pred zverejnením adresy iným vláknam. Príklad skutočne inicializuje atomic_int na 42 a potom ho prečíta pomocou atomic_load.
atomic_init nesynchronizuje: ľubovoľný súbežný prístup počas inicializácie, aj atómový, vytvára dátové preteky. Neatómový zápis do ktoréhokoľvek bajtu, aj cez memcpy či memset, urobí reprezentáciu neurčitou. Volanie z obsluhy signálu má nedefinované správanie okrem prípadu, keď signál pochádza z abort alebo raise; predvolená inicializácia dáva statickým a vláknovým objektom okrem atomic_flag platný stav.
Názov tejto generickej funkcie môže byť makro alebo externý identifikátor; potlačenie makra na volanie skutočnej funkcie alebo definovanie externého identifikátora s týmto názvom má nedefinované správanie.
Príklady
#include <stdatomic.h>
#include <stdio.h>
int main(void) {
atomic_int value;
atomic_init(&value, 42);
printf("%d\n", atomic_load(&value));
return 0;
}
Výsledok
42
Použite ju na uvedenie automatického alebo alokovaného atómového objektu do platného stavu pred zverejnením adresy iným vláknam. Príklad skutočne inicializuje `atomic_int` na `42` a potom ho prečíta pomocou `atomic_load`.