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

CKTIS / C

mtx_timedlock — заключване на мютекс със срок

`mtx_timedlock` се опитва да заключи мютекс до абсолютен срок, основан на `TIME_UTC`. Разграничава успешно придобиване на заключването, изтичане на срока и грешка.

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

Синтаксис

#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);

mtx_timedlock от <threads.h> изчаква заключването или до срока ts: това е абсолютно време в TIME_UTC, а не продължителност на изчакване или монотонно време. Срокът не гарантира точен момент на връщане.

Инициализирайте мютекса с mtx_init и mtx_timed или mtx_timed | mtx_recursive; само mtx_plain не е достатъчен. Резултатите са thrd_success, thrd_timedout и thrd_error. Освободете придобитото заключване с mtx_unlock само при успех.

Примерът използва отключен мютекс и задава срок, който изтича една секунда след отчетения момент в TIME_UTC. Той не налага конкуренция между нишките. Поддръжката по време на изпълнение не е потвърдена.

Примери

#include <stdio.h>
#include <threads.h>
#include <time.h>

int main(void)
{
    mtx_t mutex;
    struct timespec deadline;

    if (mtx_init(&mutex, mtx_timed) != thrd_success)
        return 1;
    if (timespec_get(&deadline, TIME_UTC) != TIME_UTC) {
        mtx_destroy(&mutex);
        return 1;
    }

    deadline.tv_sec += 1;

    int result = mtx_timedlock(&mutex, &deadline);
    if (result == thrd_success) {
        if (mtx_unlock(&mutex) != thrd_success)
            return 1;
        puts("locked");
    } else if (result == thrd_timedout) {
        puts("timeout");
    } else {
        mtx_destroy(&mutex);
        return 1;
    }
    mtx_destroy(&mutex);
    return 0;
}

Резултат

locked

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

Източници