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

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.

Fontes