Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti