Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje