CKTIS / C
mtx_init — inicializace mutexu
mtx_init z <threads.h> inicializuje mutex se zvolenými vlastnostmi. Před použitím objektu zkontrolujte výsledek a jeho životní cyklus ukončete voláním mtx_destroy.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init uloží identifikátor nového mutexu do objektu mtx_t, na který ukazuje mtx. Funkce vrací thrd_success nebo thrd_error. Pokud selže, nepoužívejte objekt jako inicializovaný mutex.
type musí být jedna ze čtyř hodnot: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. První dvě označují nerekurzivní mutexy; mtx_recursive umožňuje stejnému vláknu mutex opakovaně zamknout a mtx_timed podporuje časové limity.
Mutex inicializujte před zpřístupněním ostatním vláknům. Aktivní mutex znovu neinicializujte. Po použití zavolejte mtx_destroy; v tu chvíli nesmí na tento mutex čekat žádné vlákno.
Podpora <threads.h> je volitelná; hodnota 1 u __STDC_NO_THREADS__ znamená, že chybí. Příznak C23 v repozitáři nepotvrzuje dostupnost běhové knihovny v produkčním prostředí.
Pří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ýsledek
OK
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.