Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje