CKTIS / C
mtx_init — inicializacija mutexa
mtx_init iz <threads.h> inicializira mutex z izbranimi lastnostmi. Pred uporabo objekta preverite rezultat, njegov življenjski cikel pa zaključite s klicem mtx_destroy.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init shrani identifikator novega mutexa v objekt mtx_t, na katerega kaže mtx. Funkcija vrne thrd_success ali thrd_error. Če pride do napake, objekta ne uporabljajte kot inicializiran mutex.
type mora biti ena od štirih vrednosti: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Prvi dve označujeta nerekurzivna mutexa; mtx_recursive isti niti omogoča, da isti mutex zaklene večkrat, mtx_timed pa podpira časovne omejitve.
Mutex inicializirajte, preden ga daste na voljo drugim nitim. Aktivnega mutexa ne inicializirajte znova. Po uporabi pokličite mtx_destroy; takrat na ta mutex ne sme čakati nobena nit.
Podpora za <threads.h> je neobvezna; vrednost 1 za __STDC_NO_THREADS__ pomeni, da ni na voljo. Zastavica C23 v repozitoriju ne potrjuje razpoložljivosti izvajalne knjižnice v produkcijskem okolju.
Primeri
#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
Rezultat
OK
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.