WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

mtx_lock — Mutex sperren

mtx_lock wartet darauf, einen Mutex zu übernehmen. Bei Erfolg wird thrd_success zurückgegeben, bei einem Fehler thrd_error.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <threads.h>
int mtx_lock(mtx_t *mtx);

mtx_lock aus <threads.h> blockiert die Ausführung, bis der durch mtx angegebene Mutex übernommen wurde. Initialisiere ihn zuvor erfolgreich mit mtx_init. Nach erfolgreicher Übernahme führe den kritischen Abschnitt aus und rufe anschließend mtx_unlock auf.

Rufe diese Funktion nicht erneut für einen nichtrekursiven Mutex auf, den der aufrufende Thread bereits besitzt: Das ist undefiniertes Verhalten und kein garantierter Fehler. Frühere Entsperrungen desselben Mutex synchronisieren sich mit seiner Übernahme.

Das Beispiel verwendet einen einzelnen Thread und zeigt den Lebenszyklus des Mutex, nicht die Konkurrenz zwischen Threads. Die Auswahl des C23-Modus allein belegt nicht, dass die Laufzeitbibliothek Thread-Unterstützung bietet.

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;

    if (mtx_unlock(&mutex) != thrd_success)
        abort();

    mtx_destroy(&mutex);
    printf("%d\n", value);
    return EXIT_SUCCESS;
}

Ergebnis

1

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