База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

mtx_lock — заключване на mutex

Функцията mtx_lock изчаква, докато придобие mutex. При успех връща thrd_success, а при грешка — thrd_error.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <threads.h>
int mtx_lock(mtx_t *mtx);

mtx_lock от <threads.h> блокира изпълнението, докато придобие mutex-а, към който сочи mtx. Първо го инициализирайте успешно с mtx_init. След придобиването изпълнете критичната секция, а след това извикайте mtx_unlock.

Не извиквайте функцията отново за нерекурсивен mutex, който вече е притежание на извикващата нишка: това е недефинирано поведение, а не гарантирана грешка. Предишните отключвания на същия mutex се синхронизират с придобиването му.

Примерът използва една нишка, за да покаже жизнения цикъл на mutex-а, а не съревнованието между нишки. Самият избор на режим C23 не доказва, че библиотеката за изпълнение поддържа нишки.

Примери

#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;
}

Резултат

1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници