CKTIS / C
mtx_destroy — Mutex-Ressourcen freigeben
mtx_destroy aus <threads.h> gibt die Ressourcen eines Mutex frei. Die Funktion liefert keinen Wert zurück; während der Zerstörung darf kein Thread auf diesen Mutex warten.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
void mtx_destroy(mtx_t *mtx);mtx_destroy(mtx_t *mtx) gibt die Ressourcen frei, die der angegebene Mutex verwendet. Die Funktion ist in <threads.h> deklariert und gibt void zurück, keinen Erfolgscode.
Die normative Bedingung lautet, dass kein Thread blockiert auf diesen Mutex warten darf. Ein sicheres Aufräummuster ist, die Verwendung zu beenden, den Mutex entsperrt zu lassen und dann mtx_destroy aufzurufen. Betrachte die Zerstörung nicht als Ersatz für mtx_unlock.
Das Beispiel zerstört den Mutex nur nach erfolgreichem mtx_init. Es erstellt keine zusätzlichen Threads, daher gibt es keine wartenden Threads.
Beispiele
#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;
}
Ergebnis
Mutex destroyed.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.