Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

mtx_timedlock — bloquear un mutex con un plazo límite

`mtx_timedlock` intenta bloquear un mutex antes de un plazo absoluto basado en `TIME_UTC`. Distingue entre la adquisición correcta, el vencimiento del plazo y un error.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

mtx_timedlock de <threads.h> espera el bloqueo o hasta el plazo ts: una hora absoluta en TIME_UTC, no una duración de espera ni una hora monotónica. El plazo no garantiza un instante exacto de retorno.

Inicializa el mutex con mtx_init y mtx_timed o mtx_timed | mtx_recursive; mtx_plain por sí solo no es suficiente. Los resultados son thrd_success, thrd_timedout y thrd_error. Libera el bloqueo adquirido con mtx_unlock solo si la operación tiene éxito.

El ejemplo usa un mutex desbloqueado y fija el vencimiento del plazo un segundo después del instante registrado en TIME_UTC. No fuerza la contención entre hilos. La compatibilidad en tiempo de ejecución no está acreditada.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes