CKTIS / C
mtx_lock — bloccare un mutex
mtx_lock attende di acquisire un mutex. Restituisce thrd_success in caso di successo oppure thrd_error in caso di errore.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <threads.h>
int mtx_lock(mtx_t *mtx);mtx_lock di <threads.h> blocca l’esecuzione finché non acquisisce il mutex indicato da mtx. Inizializzalo prima correttamente con mtx_init. Dopo averlo acquisito, esegui la sezione critica e poi chiama mtx_unlock.
Non chiamare di nuovo questa funzione per un mutex non ricorsivo già posseduto dal thread chiamante: si tratta di comportamento indefinito, non di un errore garantito. Gli sblocchi precedenti dello stesso mutex si sincronizzano con la sua acquisizione.
L’esempio usa un solo thread per mostrare il ciclo di vita del mutex, non la contesa tra thread. La sola selezione della modalità C23 non attesta il supporto ai thread nella libreria di runtime.
Esempi
#include <stdio.h>
#include <stdlib.h>
#include <threads.h>
int main(void)
{
mtx_t mutex;
int value = 0;
if (mtx_init(&mutex, mtx_plain) != thrd_success)
return EXIT_FAILURE;
if (mtx_lock(&mutex) != thrd_success) {
mtx_destroy(&mutex);
return EXIT_FAILURE;
}
++value;
if (mtx_unlock(&mutex) != thrd_success)
abort();
mtx_destroy(&mutex);
printf("%d\n", value);
return EXIT_SUCCESS;
}Risultato
1
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.