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.