CKTIS / C
mtx_init — inicjalizacja muteksu
mtx_init z <threads.h> inicjalizuje muteks o wybranych właściwościach. Sprawdź wynik przed użyciem obiektu i zakończ jego cykl życia przez mtx_destroy.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init zapisuje w obiekcie mtx_t wskazywanym przez mtx identyfikator nowego muteksu. Wynikiem jest thrd_success albo thrd_error; po błędzie nie używaj obiektu jako zainicjalizowanego muteksu.
type musi być jedną z czterech wartości: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Pierwsze dwie oznaczają muteksy nierekurencyjne; mtx_recursive umożliwia ponowne zablokowanie przez ten sam wątek, a mtx_timed obsługę limitu czasu.
Inicjalizuj przed udostępnieniem innym wątkom. Nie inicjalizuj ponownie aktywnego muteksu. Po zakończeniu używania wywołaj mtx_destroy; żaden wątek nie może wtedy oczekiwać na ten muteks.
Obsługa <threads.h> jest opcjonalna; __STDC_NO_THREADS__ równe 1 sygnalizuje jej brak. Flaga C23 w repozytorium nie potwierdza dostępności biblioteki wykonawczej w środowisku produkcyjnym.
Przykłady
#include <stdio.h>
#include <stdlib.h>
#if defined(__STDC_NO_THREADS__) && __STDC_NO_THREADS__ == 1
#error "Threads support required"
#else
#include <threads.h>
int main(void)
{
mtx_t mutex;
if (mtx_init(&mutex, mtx_plain) != thrd_success) {
fputs("mtx_init failed\n", stderr);
return EXIT_FAILURE;
}
mtx_destroy(&mutex);
puts("OK");
return EXIT_SUCCESS;
}
#endif
Wynik
OK
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.