CKTIS / C
mtx_timedlock — een mutex vergrendelen met een deadline
`mtx_timedlock` probeert een mutex te vergrendelen vóór een absolute deadline op basis van `TIME_UTC`. De uitkomst maakt onderscheid tussen een geslaagde vergrendeling, een verstreken deadline en een fout.
Versie: 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 uit <threads.h> wacht op een vergrendeling of tot de deadline ts: een absolute tijd in TIME_UTC, geen wachttijdsduur en geen monotone tijd. De deadline garandeert geen exact tijdstip waarop de functie terugkeert.
Initialiseer de mutex met mtx_init en mtx_timed of mtx_timed | mtx_recursive; alleen mtx_plain is niet voldoende. De resultaten zijn thrd_success, thrd_timedout en thrd_error. Geef de verkregen vergrendeling alleen na succes vrij met mtx_unlock.
Het voorbeeld gebruikt een niet-vergrendelde mutex en stelt de deadline in op één seconde na het uitgelezen TIME_UTC-tijdstip. Het dwingt geen concurrentie tussen threads af. Ondersteuning tijdens uitvoering is niet bevestigd.
Voorbeelden
#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;
}Resultaat
locked
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.