Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła