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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.