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

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.

Fontes