CKTIS / C
mtx_init — inizializzare un mutex
mtx_init di <threads.h> inizializza un mutex con le proprietà scelte. Controlla il risultato prima di usare l’oggetto e termina il suo ciclo di vita con mtx_destroy.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init memorizza l’identificatore di un nuovo mutex nell’oggetto mtx_t puntato da mtx. La funzione restituisce thrd_success oppure thrd_error. In caso di errore, non usare l’oggetto come mutex inizializzato.
type deve essere uno di questi quattro valori: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. I primi due indicano mutex non ricorsivi; mtx_recursive consente allo stesso thread di bloccare il mutex più volte, mentre mtx_timed supporta i limiti di tempo.
Inizializza il mutex prima di condividerlo con altri thread. Non inizializzare di nuovo un mutex attivo. Dopo l’uso, chiama mtx_destroy; a quel punto nessun thread deve essere in attesa di quel mutex.
Il supporto per <threads.h> è facoltativo; un valore di 1 per __STDC_NO_THREADS__ ne indica l’assenza. L’opzione C23 del repository non attesta la disponibilità della libreria di runtime in produzione.
Esempi
#include <stdio.h>
#include <stdlib.h>
#if defined(__STDC_NO_THREADS__) && __STDC_NO_THREADS__ == 1
#error "Threads support required"
#else
#include <threads.h>
int main(void)
{
mtx_t mutex;
if (mtx_init(&mutex, mtx_plain) != thrd_success) {
fputs("mtx_init failed\n", stderr);
return EXIT_FAILURE;
}
mtx_destroy(&mutex);
puts("OK");
return EXIT_SUCCESS;
}
#endif
Risultato
OK
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.