WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen