CKTIS / C
mtx_timedlock — bloquear um mutex com um prazo limite
`mtx_timedlock` tenta bloquear um mutex até um prazo absoluto baseado em `TIME_UTC`. Distingue entre aquisição bem-sucedida, prazo excedido e erro.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);mtx_timedlock de <threads.h> espera pelo bloqueio ou até ao prazo ts: uma hora absoluta em TIME_UTC, não uma duração de espera nem uma hora monotónica. O prazo não garante um instante exato de retorno.
Inicialize o mutex com mtx_init e mtx_timed ou mtx_timed | mtx_recursive; mtx_plain por si só não é suficiente. Os resultados são thrd_success, thrd_timedout e thrd_error. Liberte o bloqueio adquirido com mtx_unlock apenas em caso de sucesso.
O exemplo utiliza um mutex desbloqueado e define o fim do prazo para um segundo após o instante registado em TIME_UTC. Não força a contenção entre threads. O suporte em tempo de execução não foi atestado.
Exemplos
#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;
}Resultado
locked
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.