CKTIS / C
mtx_destroy — libertar os recursos do mutex
mtx_destroy de <threads.h> liberta os recursos de um mutex. Não devolve qualquer valor; durante a destruição, nenhuma thread pode estar bloqueada à espera desse mutex.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <threads.h>
void mtx_destroy(mtx_t *mtx);mtx_destroy(mtx_t *mtx) liberta os recursos utilizados pelo mutex indicado. A função está declarada em <threads.h> e devolve void, não um código de sucesso.
A condição normativa é que nenhuma thread pode estar bloqueada à espera deste mutex. Um procedimento seguro de limpeza consiste em terminar a sua utilização, deixá-lo desbloqueado e, em seguida, chamar mtx_destroy. Não considere a destruição um substituto de mtx_unlock.
O exemplo destrói o mutex apenas depois de mtx_init ter sido bem-sucedida. Não cria threads adicionais, pelo que não existem threads à espera.
Exemplos
#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;
}
Resultado
Mutex destroyed.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.