CKTIS / C
mtx_lock — bloquear um mutex
mtx_lock espera até adquirir um mutex. Devolve thrd_success em caso de sucesso ou thrd_error em caso de erro.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <threads.h>
int mtx_lock(mtx_t *mtx);mtx_lock, de <threads.h>, bloqueia a execução até adquirir o mutex indicado por mtx. Primeiro, inicialize-o corretamente com mtx_init. Depois de o adquirir, execute a secção crítica e, em seguida, chame mtx_unlock.
Não chame esta função novamente para um mutex não recursivo que já pertença à thread que faz a chamada: isso é comportamento indefinido, não um erro garantido. Os desbloqueios anteriores do mesmo mutex sincronizam-se com a sua aquisição.
O exemplo usa uma única thread para demonstrar o ciclo de vida do mutex, não a contenção entre threads. A escolha do modo C23, por si só, não comprova que a biblioteca de execução suporte threads.
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;
if (mtx_unlock(&mutex) != thrd_success)
abort();
mtx_destroy(&mutex);
printf("%d\n", value);
return EXIT_SUCCESS;
}Resultado
1
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.