Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes