Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources