CKTIS / C
mtx_unlock — einen Mutex entsperren
mtx_unlock aus <threads.h> entsperrt einen Mutex, der dem aufrufenden Thread gehört, und gibt einen Erfolgs- oder Fehlercode zurück.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_unlock(mtx_t *mtx);mtx_unlock(mtx) entsperrt den Mutex, auf den mtx zeigt. Das Argument muss auf einen initialisierten, weiterhin existierenden Mutex zeigen, der vom aufrufenden Thread gesperrt wurde. Das Entsperren eines nicht gesperrten Mutex oder eines Mutex, der einem anderen Thread gehört, führt zu undefiniertem Verhalten.
Bei Erfolg wird thrd_success zurückgegeben; kann die Anforderung nicht erfüllt werden, wird thrd_error zurückgegeben. Ein Fehlercode hebt die Einhaltung der Aufrufbedingungen nicht auf. Das Entsperren synchronisiert sich mit einem späteren Sperren desselben Mutex und macht dadurch geschützte Schreibzugriffe sichtbar.
Das Beispiel verwendet einen einzelnen Thread: Es initialisiert den Mutex, sperrt ihn, setzt value, entsperrt ihn und zerstört ihn. Es zeigt den Lebenszyklus, nicht die Konkurrenz zwischen Threads. Die Auswahl des C23-Modus allein gewährleistet nicht, dass die Thread-Bibliothek zur Laufzeit verfügbar ist.
Beispiele
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
int main(void)
{
mtx_t mutex;
int value = 0;
if (mtx_init(&mutex, mtx_plain) != thrd_success)
return EXIT_FAILURE;
if (mtx_lock(&mutex) != thrd_success) {
mtx_destroy(&mutex);
return EXIT_FAILURE;
}
value = 42;
if (mtx_unlock(&mutex) != thrd_success)
abort();
mtx_destroy(&mutex);
printf("%d\n", value);
return EXIT_SUCCESS;
}Ergebnis
42
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.