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

CKTIS / C

mtx_unlock — desbloquear um mutex

mtx_unlock de <threads.h> desbloqueia um mutex pertencente à thread que faz a chamada e devolve um código de sucesso ou de erro.

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

Sintaxe

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

mtx_unlock(mtx) desbloqueia o mutex para o qual mtx aponta. O argumento tem de apontar para um mutex inicializado, que ainda exista e esteja bloqueado pela thread que faz a chamada. Desbloquear um mutex que não esteja bloqueado ou que pertença a outra thread provoca comportamento indefinido.

Devolve thrd_success em caso de sucesso ou thrd_error quando não é possível satisfazer o pedido. Um código de erro não substitui o cumprimento dos requisitos da chamada. O desbloqueio sincroniza-se com uma aquisição posterior do mesmo mutex, tornando visíveis as escritas protegidas.

O exemplo utiliza uma única thread: inicializa o mutex, bloqueia-o, atribui um valor a value, desbloqueia-o e destrói-o. Demonstra o ciclo de vida, não a contenção entre threads. A escolha do modo C23, por si só, não garante a disponibilidade da biblioteca de threads durante a execução.

Exemplos

#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

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