Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori