WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

mtx_trylock — Versuch, einen Mutex ohne Wartezeit zu sperren

mtx_trylock versucht, einen Mutex zu sperren, ohne auf seine Freigabe zu warten. Das Ergebnis unterscheidet zwischen Erfolg, Belegung und Fehler.

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

Syntax

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

mtx_trylock aus <threads.h> erhält einen Zeiger auf ein initialisiertes Objekt vom Typ mtx_t. Anders als mtx_lock wartet die Funktion nicht darauf, dass ein belegter Mutex freigegeben wird.

Sie gibt thrd_success, thrd_busy oder thrd_error zurück. In C23 kann der Sperrversuch auch dann fehlschlagen, wenn der Mutex nicht gesperrt ist: Die Funktion kann in diesem Fall thrd_busy zurückgeben.

Nur bei Erfolg sind geschützte Operationen zulässig; rufe danach mtx_unlock auf. Das erfolgreiche Sperren synchronisiert sich mit früheren Aufrufen von mtx_unlock für denselben Mutex. Ein Fehlschlag bietet keine solche Synchronisierung.

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;

    int result = mtx_trylock(&mutex);
    if (result == thrd_success) {
        /* Protected work belongs here. */
        if (mtx_unlock(&mutex) != thrd_success)
            return EXIT_FAILURE;
    } else if (result != thrd_busy) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("done");
    return EXIT_SUCCESS;
}

Ergebnis

done

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