Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes