Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri