Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

mtx_destroy — liberar los recursos del mutex

mtx_destroy de <threads.h> libera los recursos de un mutex. No devuelve ningún valor; durante su destrucción, ningún hilo puede estar bloqueado esperando ese mutex.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

mtx_destroy(mtx_t *mtx) libera los recursos utilizados por el mutex indicado. La función está declarada en <threads.h> y devuelve void, no un código de éxito.

La condición normativa es que ningún hilo puede estar bloqueado esperando este mutex. Una forma segura de limpiar es terminar de usarlo, dejarlo desbloqueado y después llamar a mtx_destroy. No consideres la destrucción como un sustituto de mtx_unlock.

El ejemplo destruye el mutex solo después de que mtx_init se haya ejecutado correctamente. No crea hilos adicionales, así que no hay hilos esperando.

Ejemplos

#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.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes