Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

mtx_trylock — pokus o zamčení mutexu bez čekání

mtx_trylock se pokouší získat mutex, aniž by čekala na jeho uvolnění. Výsledek rozlišuje úspěch, obsazenost a chybu.

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

Syntaxe

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

mtx_trylock z <threads.h> přijímá ukazatel na inicializovaný mtx_t. Na rozdíl od mtx_lock nečeká, až se obsazený mutex uvolní.

Vrací thrd_success, thrd_busy nebo thrd_error. V C23 může pokus selhat a funkce vrátit thrd_busy, i když mutex není zamčený.

Pouze úspěch dovoluje provádět chráněné operace; poté zavolej mtx_unlock. Úspěšné získání se synchronizuje s předchozími voláními mtx_unlock pro tento mutex. Neúspěch takovou synchronizaci nezajišťuje.

Příklady

#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;
}

Výsledek

done

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje