Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

mtx_destroy — rilasciare le risorse del mutex

mtx_destroy di <threads.h> rilascia le risorse di un mutex. Non restituisce alcun valore; durante la distruzione nessun thread può essere bloccato in attesa di quel mutex.

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

Sintassi

#include <threads.h>
void mtx_destroy(mtx_t *mtx);

mtx_destroy(mtx_t *mtx) rilascia le risorse utilizzate dal mutex indicato. La funzione è dichiarata in <threads.h> e restituisce void, non un codice di successo.

La condizione normativa è che nessun thread possa essere bloccato in attesa di questo mutex. Una procedura di pulizia sicura consiste nel terminare di usarlo, lasciarlo sbloccato e poi chiamare mtx_destroy. Non considerare la distruzione un sostituto di mtx_unlock.

L’esempio distrugge il mutex solo dopo che mtx_init è riuscita. Non crea thread aggiuntivi, quindi non ci sono thread in attesa.

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;
    }

    mtx_destroy(&mutex);
    puts("Mutex destroyed.");
    return EXIT_SUCCESS;
}

Risultato

Mutex destroyed.

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