CKTIS / C
mtx_init — inicializar um mutex
mtx_init de <threads.h> inicializa um mutex com as propriedades escolhidas. Verifique o resultado antes de utilizar o objeto e termine o seu ciclo de vida com mtx_destroy.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <threads.h>
int mtx_init(mtx_t *mtx, int type);mtx_init guarda o identificador de um novo mutex no objeto mtx_t apontado por mtx. A função devolve thrd_success ou thrd_error. Em caso de falha, não utilize o objeto como se fosse um mutex inicializado.
type tem de ser um de quatro valores: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Os dois primeiros representam mutexes não recursivos; mtx_recursive permite que a mesma thread bloqueie o mutex repetidamente, e mtx_timed suporta limites de tempo.
Inicialize o mutex antes de o partilhar com outras threads. Não volte a inicializar um mutex ativo. Depois de o utilizar, chame mtx_destroy; nessa altura, nenhuma thread pode estar à espera desse mutex.
O suporte para <threads.h> é opcional; um valor de 1 para __STDC_NO_THREADS__ indica que não está disponível. A opção C23 do repositório não atesta a disponibilidade da biblioteca de execução em produção.
Exemplos
#include <stdio.h>
#include <stdlib.h>
#if defined(__STDC_NO_THREADS__) && __STDC_NO_THREADS__ == 1
#error "Threads support required"
#else
#include <threads.h>
int main(void)
{
mtx_t mutex;
if (mtx_init(&mutex, mtx_plain) != thrd_success) {
fputs("mtx_init failed\n", stderr);
return EXIT_FAILURE;
}
mtx_destroy(&mutex);
puts("OK");
return EXIT_SUCCESS;
}
#endif
Resultado
OK
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.