База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

mtx_trylock — опит за заключване на мютекс без изчакване

mtx_trylock прави опит да заключи мютекс, без да чака освобождаването му. Резултатът различава успех, заетост и грешка.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

mtx_trylock от <threads.h> приема указател към инициализиран mtx_t. За разлика от mtx_lock, функцията не изчаква зает мютекс да стане достъпен.

Тя връща thrd_success, thrd_busy или thrd_error. В C23 опитът може да се провали дори когато мютексът не е заключен: функцията може да върне thrd_busy и в този случай.

Само успехът позволява извършването на защитени операции; след това извикай mtx_unlock. Успешното придобиване се синхронизира с предишни извиквания на mtx_unlock за този мютекс. Неуспехът не осигурява такава синхронизация.

Примери

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

Резултат

done

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници