Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

mtx_timedlock — zamknutie mutexu s časovým limitom

`mtx_timedlock` sa pokúsi zamknúť mutex do absolútneho termínu založeného na `TIME_UTC`. Rozlišuje úspešné získanie zámku, prekročenie termínu a chybu.

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

Syntax

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

mtx_timedlock z <threads.h> čaká na zámok alebo do termínu ts: ide o absolútny čas v TIME_UTC, nie o dobu čakania ani monotónny čas. Termín nezaručuje presný okamih návratu.

Mutex inicializujte pomocou mtx_init s mtx_timed alebo mtx_timed | mtx_recursive; samotné mtx_plain nestačí. Výsledky sú thrd_success, thrd_timedout a thrd_error. Získaný zámok uvoľnite pomocou mtx_unlock iba po úspechu.

Príklad používa odomknutý mutex a nastaví termín o jednu sekundu neskôr, než je načítaný čas TIME_UTC. Nevynucuje súperenie medzi vláknami. Podpora počas behu nebola potvrdená.

Príklady

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

Výsledok

locked

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje