База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

atomic_init — атомарна обобщена функция на C23

`atomic_init(obj, value)` от `<stdatomic.h>` инициализира посочения атомарен обект със `value`, включително допълнително състояние на реализацията, и не връща стойност. Ако паметта няма деклариран тип, извикването ѝ дава ефективния атомарен тип `A`.

Версия: C23

Синтаксис

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

atomic_init(obj, value) от <stdatomic.h> инициализира посочения атомарен обект със value, включително допълнително състояние на реализацията, и не връща стойност. Ако паметта няма деклариран тип, извикването ѝ дава ефективния атомарен тип A.

Използвайте я, за да приведете автоматичен или заделен атомарен обект във валидно състояние, преди да публикувате адреса му към други нишки. Примерът действително инициализира atomic_int с 42 и после го чете чрез atomic_load.

atomic_init не синхронизира: всеки едновременен достъп по време на инициализацията, дори атомарен, създава надпревара за данни. Неатомарен запис в който и да е байт, включително чрез memcpy или memset, прави представянето неопределено. Извикване от обработчик на сигнал има неопределено поведение, освен ако сигналът е от abort или raise; стандартната инициализация прави валидни статичните и нишковите обекти без atomic_flag.

Името на тази обобщена функция може да е макрос или външен идентификатор; потискането на макроса за извикване на действителна функция или дефинирането на външен идентификатор с това име има неопределено поведение.

Примери

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

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

Резултат

42

Използвайте я, за да приведете автоматичен или заделен атомарен обект във валидно състояние, преди да публикувате адреса му към други нишки. Примерът действително инициализира `atomic_int` с `42` и после го чете чрез `atomic_load`.

Източници