Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

mtx_trylock — poskus zaklepanja muteksa brez čakanja

mtx_trylock poskuša pridobiti muteks, ne da bi čakal na njegovo sprostitev. Rezultat razlikuje med uspehom, zasedenostjo in napako.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

mtx_trylock iz <threads.h> prejme kazalec na inicializiran mtx_t. Za razliko od mtx_lock ne čaka, da zasedeni muteks postane na voljo.

Vrne thrd_success, thrd_busy ali thrd_error. V C23 lahko poskus spodleti tudi, če muteks ni zaklenjen: funkcija lahko tudi v tem primeru vrne thrd_busy.

Samo uspeh dovoljuje izvajanje zaščitenih operacij; nato pokliči mtx_unlock. Uspešna pridobitev se sinhronizira s prejšnjimi klici mtx_unlock za ta muteks. Neuspeh takšne sinhronizacije ne zagotavlja.

Primeri

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

Rezultat

done

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri