CKTIS / C
atomic_init — atomowa funkcja generyczna C23
`atomic_init(obj, value)` z `<stdatomic.h>` inicjalizuje wskazany obiekt atomowy wartością `value`, włącznie z dodatkowym stanem wymaganym przez implementację, i niczego nie zwraca. Gdy pamięć nie ma zadeklarowanego typu, wywołanie nadaje jej efektywny typ atomowy `A`.
Wersja: C23
Składnia
void atomic_init(volatile A *obj, C value);atomic_init(obj, value) z <stdatomic.h> inicjalizuje wskazany obiekt atomowy wartością value, włącznie z dodatkowym stanem wymaganym przez implementację, i niczego nie zwraca. Gdy pamięć nie ma zadeklarowanego typu, wywołanie nadaje jej efektywny typ atomowy A.
Używaj jej do doprowadzenia atomu o czasie automatycznym lub w zaalokowanej pamięci do poprawnego stanu przed opublikowaniem wskaźnika innym wątkom. Przykład inicjalizuje atomic_int liczbą 42, a następnie rzeczywiście odczytuje ją przez atomic_load.
atomic_init nie jest operacją synchronizującą: każdy współbieżny dostęp podczas inicjalizacji, nawet atomowy, tworzy wyścig danych. Zapis nieatomowy do dowolnego bajtu atomu, także przez memcpy lub memset, czyni reprezentację nieokreśloną. Wywołanie z procedury obsługi sygnału ma niezdefiniowane zachowanie, chyba że sygnał wynika z abort lub raise; obiekty statyczne i wątkowe inne niż atomic_flag mają poprawny stan po domyślnej inicjalizacji.
Nazwa tej funkcji generycznej może być makrem albo identyfikatorem zewnętrznym; stłumienie makra w celu wywołania rzeczywistej funkcji lub zdefiniowanie zewnętrznego identyfikatora o tej nazwie ma niezdefiniowane zachowanie.
Przykłady
#include <stdatomic.h>
#include <stdio.h>
int main(void) {
atomic_int value;
atomic_init(&value, 42);
printf("%d\n", atomic_load(&value));
return 0;
}
Wynik
42
Używaj jej do doprowadzenia atomu o czasie automatycznym lub w zaalokowanej pamięci do poprawnego stanu przed opublikowaniem wskaźnika innym wątkom. Przykład inicjalizuje `atomic_int` liczbą `42`, a następnie rzeczywiście odczytuje ją przez `atomic_load`.