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

CKTIS / C

mtx_trylock — tentar bloquear um mutex sem esperar

mtx_trylock tenta adquirir um mutex sem esperar que seja libertado. O resultado distingue entre sucesso, ocupado e erro.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

mtx_trylock de <threads.h> recebe um apontador para um mtx_t inicializado. Ao contrário de mtx_lock, não espera que um mutex ocupado fique disponível.

Devolve thrd_success, thrd_busy ou thrd_error. Em C23, a tentativa pode falhar de forma espúria e devolver thrd_busy mesmo que o mutex não esteja bloqueado.

Só o sucesso permite executar operações protegidas; depois, chama mtx_unlock. Uma aquisição bem-sucedida sincroniza-se com chamadas anteriores a mtx_unlock nesse mutex. O insucesso não proporciona essa sincronização.

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;

    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

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