Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

mtx_trylock — tentare di bloccare un mutex senza attendere

mtx_trylock tenta di acquisire un mutex senza attendere che venga rilasciato. Il risultato distingue tra successo, occupato ed errore.

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

Sintassi

#include <threads.h>
int mtx_trylock(mtx_t *mtx);

mtx_trylock di <threads.h> riceve un puntatore a un mtx_t inizializzato. A differenza di mtx_lock, non attende che un mutex occupato diventi disponibile.

Restituisce thrd_success, thrd_busy o thrd_error. In C23, il tentativo può fallire in modo spurio e restituire thrd_busy anche se il mutex non è bloccato.

Solo il successo consente di eseguire operazioni protette; in seguito, chiama mtx_unlock. L’acquisizione riuscita si sincronizza con le chiamate precedenti a mtx_unlock su quel mutex. Il fallimento non fornisce tale sincronizzazione.

Esempi

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    mtx_t mutex;
    if (mtx_init(&mutex, mtx_plain) != thrd_success)
        return EXIT_FAILURE;

    int result = mtx_trylock(&mutex);
    if (result == thrd_success) {
        /* Protected work belongs here. */
        if (mtx_unlock(&mutex) != thrd_success)
            return EXIT_FAILURE;
    } else if (result != thrd_busy) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("done");
    return EXIT_SUCCESS;
}

Risultato

done

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti