CKTIS / C
mtx_init — inicijalizacija mutexa
mtx_init iz <threads.h> inicijalizira mutex s odabranim svojstvima. Provjerite rezultat prije upotrebe objekta i završite njegov životni ciklus pozivom mtx_destroy.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init pohranjuje identifikator novog mutexa u objekt mtx_t na koji pokazuje mtx. Funkcija vraća thrd_success ili thrd_error. Ako ne uspije, nemojte upotrebljavati objekt kao inicijalizirani mutex.
type mora biti jedna od četiri vrijednosti: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Prve dvije označavaju nerekurzivne mutexove; mtx_recursive omogućuje istoj dretvi višestruko zaključavanje mutexa, a mtx_timed podržava vremenska ograničenja.
Inicijalizirajte mutex prije nego što ga podijelite s drugim dretvama. Nemojte ponovno inicijalizirati aktivan mutex. Nakon upotrebe pozovite mtx_destroy; tada nijedna dretva ne smije čekati taj mutex.
Podrška za <threads.h> nije obavezna; vrijednost 1 za __STDC_NO_THREADS__ znači da nije dostupna. Oznaka C23 u repozitoriju ne potvrđuje dostupnost biblioteke za izvođenje u produkcijskom okruženju.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.