Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

mtx_timedlock — zaključavanje mutexa do roka

`mtx_timedlock` pokušava zaključati mutex do apsolutnog roka temeljenog na `TIME_UTC`. Razlikuje uspješno zaključavanje, istek roka i pogrešku.

Verzija: 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> čeka na zaključavanje ili do roka ts: riječ je o apsolutnom vremenu u TIME_UTC, a ne o trajanju čekanja ni monotonu vremenu. Rok ne jamči točan trenutak povratka.

Mutex inicijalizirajte pomoću mtx_init s mtx_timed ili mtx_timed | mtx_recursive; samo mtx_plain nije dovoljno. Rezultati su thrd_success, thrd_timedout i thrd_error. Dobiveno zaključavanje oslobodite pomoću mtx_unlock samo nakon uspjeha.

Primjer upotrebljava otključani mutex i postavlja rok jednu sekundu nakon očitanog vremena TIME_UTC. Ne izaziva nadmetanje među dretvama. Podrška tijekom izvođenja nije potvrđena.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori