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

CKTIS / C

mtx_trylock — intentar bloquear un mutex sin esperar

mtx_trylock intenta adquirir un mutex sin esperar a que se libere. El resultado distingue entre éxito, ocupado y error.

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

Sintaxis

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

mtx_trylock de <threads.h> recibe un puntero a un mtx_t inicializado. A diferencia de mtx_lock, no espera a que un mutex ocupado quede disponible.

Devuelve thrd_success, thrd_busy o thrd_error. En C23, el intento puede fallar de forma espuria y devolver thrd_busy incluso si el mutex no está bloqueado.

Solo el éxito permite realizar operaciones protegidas; después, llama a mtx_unlock. La adquisición correcta se sincroniza con las llamadas anteriores a mtx_unlock sobre ese mutex. Un fallo no proporciona esa sincronización.

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;

    int result = mtx_trylock(&mutex);
    if (result == thrd_success) {
        /* Protected work belongs here. */
        if (mtx_unlock(&mutex) != thrd_success)
            return EXIT_FAILURE;
    } else if (result != thrd_busy) {
        mtx_destroy(&mutex);
        return EXIT_FAILURE;
    }

    mtx_destroy(&mutex);
    puts("done");
    return EXIT_SUCCESS;
}

Resultado

done

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