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