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

CKTIS / C

mtx_destroy — uvolnění prostředků mutexu

mtx_destroy z <threads.h> uvolní prostředky mutexu. Funkce nevrací žádnou hodnotu; při ničení nesmí na tento mutex čekat žádné zablokované vlákno.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

#include <threads.h>
void mtx_destroy(mtx_t *mtx);

mtx_destroy(mtx_t *mtx) uvolní prostředky používané určeným mutexem. Funkce je deklarována v <threads.h> a vrací void, nikoli kód úspěchu.

Normativní podmínkou je, že žádné vlákno nesmí být zablokováno čekáním na tento mutex. Bezpečný postup úklidu spočívá v ukončení jeho používání, ponechání v odemčeném stavu a následném zavolání mtx_destroy. Nepovažujte zničení za náhradu funkce mtx_unlock.

Příklad zničí mutex pouze po úspěšném volání mtx_init. Nevytváří žádná další vlákna, takže žádná vlákna nečekají.

Příklady

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    mtx_t mutex;

    if (mtx_init(&mutex, mtx_plain) != thrd_success) {
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("Mutex destroyed.");
    return EXIT_SUCCESS;
}

Výsledek

Mutex destroyed.

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