CKTIS / C
mtx_init — Mutex initialisieren
mtx_init aus <threads.h> initialisiert einen Mutex mit ausgewählten Eigenschaften. Prüfe das Ergebnis, bevor du das Objekt verwendest, und beende seinen Lebenszyklus mit mtx_destroy.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init speichert eine Kennung für einen neuen Mutex im mtx_t-Objekt, auf das mtx zeigt. Die Funktion gibt thrd_success oder thrd_error zurück. Verwende das Objekt nach einem Fehler nicht als initialisierten Mutex.
type muss einer von vier Werten sein: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Die ersten beiden stehen für nicht rekursive Mutexes; mtx_recursive ermöglicht es demselben Thread, den Mutex wiederholt zu sperren, und mtx_timed unterstützt Zeitlimits.
Initialisiere den Mutex, bevor du ihn anderen Threads zugänglich machst. Initialisiere keinen aktiven Mutex erneut. Rufe nach der Verwendung mtx_destroy auf; dann darf kein Thread mehr auf diesen Mutex warten.
Die Unterstützung für <threads.h> ist optional; ein Wert von 1 für __STDC_NO_THREADS__ weist auf fehlende Unterstützung hin. Das C23-Compiler-Flag des Repositorys bestätigt nicht, dass die Laufzeitunterstützung in einer Produktionsumgebung verfügbar ist.
Beispiele
#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
Ergebnis
OK
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.