CKTIS / C
mtx_timedlock — verrouiller un mutex avec une échéance
`mtx_timedlock` tente de verrouiller un mutex avant une échéance absolue fondée sur `TIME_UTC`. Le résultat distingue l’acquisition réussie, l’expiration du délai et une erreur.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);mtx_timedlock de <threads.h> attend le verrou ou l’échéance ts : il s’agit d’une heure absolue en TIME_UTC, et non d’une durée d’attente ni d’une heure monotone. L’échéance ne garantit pas un instant de retour exact.
Initialisez le mutex avec mtx_init et mtx_timed ou mtx_timed | mtx_recursive ; mtx_plain seul ne suffit pas. Les résultats possibles sont thrd_success, thrd_timedout et thrd_error. Ne libérez le verrou acquis avec mtx_unlock qu’en cas de succès.
L’exemple utilise un mutex déverrouillé et fixe l’échéance une seconde après l’instant relevé en TIME_UTC. Il ne force pas la contention entre threads. La prise en charge à l’exécution n’a pas été attestée.
Exemples
#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;
}Résultat
locked
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.