Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

mtx_timedlock — bloccare un mutex entro una scadenza

`mtx_timedlock` tenta di bloccare un mutex entro una scadenza assoluta basata su `TIME_UTC`. Distingue tra acquisizione riuscita, scadenza del termine ed errore.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

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

mtx_timedlock di <threads.h> attende il blocco o la scadenza ts: un’ora assoluta in TIME_UTC, non una durata di attesa né un’ora monotona. La scadenza non garantisce un istante esatto di ritorno.

Inizializza il mutex con mtx_init e mtx_timed oppure mtx_timed | mtx_recursive; mtx_plain da solo non è sufficiente. I risultati sono thrd_success, thrd_timedout e thrd_error. Rilascia il blocco acquisito con mtx_unlock solo in caso di successo.

L’esempio usa un mutex sbloccato e fissa la scadenza un secondo dopo l’istante rilevato in TIME_UTC. Non forza la contesa tra thread. Il supporto in fase di esecuzione non è stato attestato.

Esempi

#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;
}

Risultato

locked

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti