KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

atomic_init — atomaire generieke C23-functie

`atomic_init(obj, value)` uit `<stdatomic.h>` initialiseert het aangewezen atomaire object met `value`, inclusief extra implementatietoestand, en retourneert niets. Als de opslag geen gedeclareerd type heeft, geeft de aanroep hem het effectieve atomaire type `A`.

Versie: C23

Syntax

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

atomic_init(obj, value) uit <stdatomic.h> initialiseert het aangewezen atomaire object met value, inclusief extra implementatietoestand, en retourneert niets. Als de opslag geen gedeclareerd type heeft, geeft de aanroep hem het effectieve atomaire type A.

Gebruik dit om een automatisch of toegewezen atomair object geldig te maken voordat het adres aan andere threads wordt gepubliceerd. Het voorbeeld initialiseert werkelijk een atomic_int met 42 en leest hem daarna via atomic_load.

atomic_init synchroniseert niet: gelijktijdige toegang tijdens initialisatie, ook atomaire, veroorzaakt een data race. Een niet-atomaire schrijfbewerking naar enig byte, ook via memcpy of memset, maakt de representatie onbepaald. Aanroep vanuit een signaalhandler heeft ongedefinieerd gedrag tenzij het signaal uit abort of raise voortkomt; standaardinitialisatie maakt statische en thread-duration objecten behalve atomic_flag geldig.

De naam van deze generieke functie kan een macro of een externe identifier zijn; de macro onderdrukken om een echte functie aan te roepen, of een externe identifier met die naam definiëren, heeft ongedefinieerd gedrag.

Voorbeelden

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_int value;
    atomic_init(&value, 42);
    printf("%d\n", atomic_load(&value));
    return 0;
}

Resultaat

42

Gebruik dit om een automatisch of toegewezen atomair object geldig te maken voordat het adres aan andere threads wordt gepubliceerd. Het voorbeeld initialiseert werkelijk een `atomic_int` met `42` en leest hem daarna via `atomic_load`.

Bronnen