CKTIS / C
mtx_init — inicializácia mutexu
mtx_init z <threads.h> inicializuje mutex so zvolenými vlastnosťami. Pred použitím objektu skontrolujte výsledok a jeho životný cyklus ukončite volaním mtx_destroy.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init uloží identifikátor nového mutexu do objektu mtx_t, na ktorý ukazuje mtx. Funkcia vracia thrd_success alebo thrd_error. Ak zlyhá, nepoužívajte objekt ako inicializovaný mutex.
type musí byť jedna zo štyroch hodnôt: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Prvé dve označujú nerekurzívne mutexy; mtx_recursive umožňuje tomu istému vláknu mutex opakovane zamknúť a mtx_timed podporuje časové limity.
Mutex inicializujte pred sprístupnením ostatným vláknam. Aktívny mutex neinicializujte znova. Po použití zavolajte mtx_destroy; v tom čase nesmie na tento mutex čakať žiadne vlákno.
Podpora <threads.h> je voliteľná; hodnota 1 pri __STDC_NO_THREADS__ znamená, že chýba. Príznak C23 v repozitári nepotvrdzuje dostupnosť runtime knižnice v produkčnom prostredí.
Príklady
#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
Výsledok
OK
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.