Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje