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.