Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

mtx_trylock — pokus o uzamknutie mutexu bez čakania

mtx_trylock sa pokúša získať mutex bez čakania na jeho uvoľnenie. Výsledok rozlišuje úspech, obsadenosť a chybu.

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

Syntax

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

mtx_trylock z <threads.h> prijíma ukazovateľ na inicializovaný mtx_t. Na rozdiel od mtx_lock nečaká, kým sa obsadený mutex uvoľní.

Vracia thrd_success, thrd_busy alebo thrd_error. V C23 môže pokus zlyhať aj vtedy, keď mutex nie je zamknutý: funkcia môže aj v takom prípade vrátiť thrd_busy.

Iba úspech umožňuje vykonávať chránené operácie; potom zavolaj mtx_unlock. Úspešné získanie sa synchronizuje s predchádzajúcimi volaniami mtx_unlock pre tento mutex. Zlyhanie takúto synchronizáciu neposkytuje.

Prí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ýsledok

done

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje