Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła