CKTIS / C
mtx_timedlock — zaklepanje mutexa z rokom
`mtx_timedlock` poskuša zakleniti mutex do absolutnega roka na podlagi `TIME_UTC`. Razlikuje med uspešno pridobitvijo zaklepa, potekom roka in napako.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);mtx_timedlock iz <threads.h> čaka na zaklep ali do roka ts: to je absolutni čas v TIME_UTC, ne trajanje čakanja ali monotoni čas. Rok ne zagotavlja točnega trenutka vrnitve.
Mutex inicializirajte z mtx_init in mtx_timed ali mtx_timed | mtx_recursive; samo mtx_plain ne zadošča. Rezultati so thrd_success, thrd_timedout in thrd_error. Pridobljeni zaklep sprostite z mtx_unlock samo ob uspehu.
Primer uporablja odklenjen mutex in določi rok za eno sekundo pozneje od odčitanega časa TIME_UTC. Ne vsili tekmovanja med nitmi. Podpora med izvajanjem ni bila potrjena.
Primeri
#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;
}Rezultat
locked
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.