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

CKTIS / C

mtx_unlock — desbloquear un mutex

mtx_unlock de <threads.h> desbloquea un mutex propiedad del hilo que realiza la llamada y devuelve un código de éxito o de error.

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

Sintaxis

#include <threads.h>
int mtx_unlock(mtx_t *mtx);

mtx_unlock(mtx) desbloquea el mutex al que apunta mtx. El argumento debe apuntar a un mutex inicializado, que siga existiendo y que esté bloqueado por el hilo que realiza la llamada. Desbloquear un mutex que no está bloqueado o que pertenece a otro hilo provoca un comportamiento indefinido.

Devuelve thrd_success si la operación tiene éxito, o thrd_error si no se puede satisfacer la solicitud. Un código de error no exime de cumplir los requisitos de la llamada. El desbloqueo se sincroniza con una adquisición posterior del mismo mutex, haciendo visibles las escrituras protegidas.

El ejemplo utiliza un solo hilo: inicializa el mutex, lo bloquea, asigna un valor a value, lo desbloquea y lo destruye. Muestra el ciclo de vida, no la competencia entre hilos. Elegir el modo C23 no garantiza por sí solo que la biblioteca de hilos esté disponible en tiempo de ejecución.

Ejemplos

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

int main(void)
{
    mtx_t mutex;
    int value = 0;

    if (mtx_init(&mutex, mtx_plain) != thrd_success)
        return EXIT_FAILURE;

    if (mtx_lock(&mutex) != thrd_success) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    value = 42;

    if (mtx_unlock(&mutex) != thrd_success)
        abort();

    mtx_destroy(&mutex);
    printf("%d\n", value);
    return EXIT_SUCCESS;
}

Resultado

42

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