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

CKTIS / C

mtx_init — инициализиране на мютекс

mtx_init от <threads.h> инициализира мютекс с избрани свойства. Проверете резултата, преди да използвате обекта, и приключете жизнения му цикъл с mtx_destroy.

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

Синтаксис

#include <threads.h>
int mtx_init(mtx_t *mtx, int type);

mtx_init записва идентификатора на нов мютекс в обекта mtx_t, към който сочи mtx. Функцията връща thrd_success или thrd_error. При неуспех не използвайте обекта като инициализиран мютекс.

type трябва да бъде една от четири стойности: mtx_plain, mtx_timed, mtx_plain | mtx_recursive, mtx_timed | mtx_recursive. Първите две обозначават нерекурсивни мютекси; mtx_recursive позволява на същата нишка да заключва мютекса многократно, а mtx_timed поддържа времеви ограничения.

Инициализирайте мютекса, преди да го споделите с други нишки. Не инициализирайте повторно активен мютекс. След употреба извикайте mtx_destroy; тогава никоя нишка не трябва да чака този мютекс.

Поддръжката на <threads.h> е незадължителна; стойност 1 на __STDC_NO_THREADS__ показва, че тя липсва. Флагът C23 в хранилището не удостоверява наличността на библиотеката по време на изпълнение в производствена среда.

Примери

#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

Резултат

OK

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

Източници