CKTIS / C
atomic_init — atomická generická funkce C23
`atomic_init(obj, value)` z `<stdatomic.h>` inicializuje zadaný atomický objekt hodnotou `value`, včetně dodatečného stavu implementace, a nic nevrací. Nemá-li úložiště deklarovaný typ, volání mu dá efektivní atomický typ `A`.
Verze: C23
Syntaxe
void atomic_init(volatile A *obj, C value);atomic_init(obj, value) z <stdatomic.h> inicializuje zadaný atomický objekt hodnotou value, včetně dodatečného stavu implementace, a nic nevrací. Nemá-li úložiště deklarovaný typ, volání mu dá efektivní atomický typ A.
Použijte ji k uvedení automatického nebo alokovaného atomického objektu do platného stavu před zveřejněním adresy jiným vláknům. Příklad skutečně inicializuje atomic_int na 42 a potom jej přečte pomocí atomic_load.
atomic_init nesynchronizuje: libovolný souběžný přístup během inicializace, i atomický, vytváří datový závod. Neatomický zápis do kteréhokoli bajtu, také přes memcpy či memset, učiní reprezentaci neurčitou. Volání z obsluhy signálu má nedefinované chování, ledaže signál pochází z abort nebo raise; výchozí inicializace dává statickým a vláknovým objektům kromě atomic_flag platný stav.
Název této generické funkce může být makro nebo externí identifikátor; potlačení makra za účelem volání skutečné funkce nebo definování externího identifikátoru tohoto názvu má nedefinované chování.
Pří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ýsledek
42
Použijte ji k uvedení automatického nebo alokovaného atomického objektu do platného stavu před zveřejněním adresy jiným vláknům. Příklad skutečně inicializuje `atomic_int` na `42` a potom jej přečte pomocí `atomic_load`.