CKTIS / C
mtx_timedlock — zamknutí mutexu s časovým limitem
`mtx_timedlock` se pokusí zamknout mutex do absolutního termínu založeného na `TIME_UTC`. Rozlišuje úspěšné získání zámku, překročení termínu a chybu.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);mtx_timedlock z <threads.h> čeká na zámek nebo do termínu ts: jde o absolutní čas v TIME_UTC, nikoli o dobu čekání ani monotónní čas. Termín nezaručuje přesný okamžik návratu.
Mutex inicializujte pomocí mtx_init s mtx_timed nebo mtx_timed | mtx_recursive; samotné mtx_plain nestačí. Výsledky jsou thrd_success, thrd_timedout a thrd_error. Získaný zámek uvolněte pomocí mtx_unlock pouze po úspěchu.
Příklad používá odemčený mutex a stanoví termín na jednu sekundu po odečteném čase TIME_UTC. Nevynucuje soupeření mezi vlákny. Podpora za běhu nebyla potvrzena.
Příklady
#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;
}Výsledek
locked
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.