threads.h (threadsQh)
Перейти к навигации
Перейти к поиску
threads.h — заголовочный файл стандартной библиотеки языка программирования С, содержащий макросы, типы, константы и функции для работы с потоками. Данный заголовочный файл появился в стандарте C11.[1]
Макросы
[править | править код]Имя | Примечания |
---|---|
thread_local |
макрос, используемый для объявления локальной переменной потока |
TSS_DTOR_ITERATIONS |
макрос, расширяемый до положительного целочисленного константного выражения, определяющего максимальное количество раз, которое деструктор для локального указателя памяти потока будет вызываться thrd_exit. |
Константы и типы
[править | править код]Имя | Примечания |
---|---|
thrd_success |
указывает на успешное выполнение |
thrd_timedout |
указывает на неудачное выполнение, завершившееся ввиду превышения времени ожидания |
thrd_busy |
указывает на неудачное выполнение, завершившееся ввиду невозможности получить доступ к ресурсу |
thrd_nomem |
указывает на неудачное выполнение, завершившееся ввиду нехватки памяти |
thrd_error |
указывает на неудачное выполнение, завершившееся ввиду какой-либо ошибки |
thrd_t |
зависящий от реализации тип, представляющий идентификатор потока |
thrd_start_t |
синоним типа int(*)(void*) , используемый функцией thrd_create
|
mtx_plain |
значение, идентифицирующее тип мьютекса, у которого нет контроля повторного захвата множество раз одним и тем же потоком |
mtx_recursive |
значение, идентифицирующее тип мьютекса, повторные захваты которого одним и тем же потоком множество раз допустимы, ведущего счётчик таких захватов |
mtx_timed |
значение, идентифицирующее тип мьютекса, поддерживающего захват с возвращением ошибки по истечении указанного времени |
mtx_t |
тип, представляющий индентификатор мьютекса |
cnd_t |
тип, представляющий индентификатор условной переменной |
tss_t |
тип, представляющий указатель на локальную память потока |
tss_dtor_t |
синоним типа void(*)(void*) , используемого в качестве деструктора локальной памяти потока
|
Функции
[править | править код]Имя | Примечания |
---|---|
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg) |
создает новый поток, исполняющий func с аргументами arg, помещая его идентификатор в thr |
int thrd_equal(thrd_t lhs, thrd_t rhs) |
проверяет, указывает ли lhs на тот же поток, что и rhs |
thrd_t thrd_current(void) |
возвращает идентификатор текущего потока |
int thrd_sleep(const struct timespec* duration, struct timespec* remaining) |
останавливает текущий поток на длительность duration, помещая оставшее до возобновления работы время в remaining, |
void thrd_yield(void) |
предоставляет планировщику задач подсказку перепланировать выполнение потоков, позволяя другим потокам работать |
_Noreturn void thrd_exit(int res) |
завершает выполнение текущего потока, устанавливая его код возврата равным res |
int thrd_detach(thrd_t thr) |
отсоединяет поток, идентефицируемый thr, от текущей среды. |
int thrd_join(thrd_t thr, int *res) |
ожидает завершение работы потока, идентифицируемого thr, помещая его код исполнения в res |
int mtx_init(mtx_t* mutex, int type) |
создает мьютекс типа type, помещая его идентификатор в переменную, на которую указывает mutex |
int mtx_lock(mtx_t* mutex) |
останавливает работу текущего потока, пока мьютекс, на который указывает mutex, не будет разблокирован |
int mtx_timedlock(mtx_t *restrict mutex, const struct timespec *restrict time_point) |
останавливает работу текущего потока, пока мьютекс, на который указывает mutex, не будет разблокирован, или пока не будет достигнут момент времени, на который указывает time_point |
int mtx_trylock(mtx_t *mutex) |
блокирует мьютекс, если он уже не заблокирован |
int mtx_unlock(mtx_t *mutex) |
разблокирует мьютекс, на который указывает mutex |
int mtx_destroy(mtx_t *mutex) |
уничтожает мьютекс, на который указывает mutex |
void call_once(once_flag* flag, void (*func)(void) func) |
вызывает функцию func ровно один раз, даже если вызывается из нескольких потоков |
int cnd_init(cnd_t* cond) |
создает условную переменную, помещая ее идентификатор в cond |
int cnd_signal(cnd_t *cond) |
разблокирует один поток, ожидающий условную переменную, на которую указывает cond |
int cnd_wait(cnd_t* cond, mtx_t* mutex) |
разблокирует мьютекс, на который указывает mutex, и блокирует переменную условия, на которую указывает cond, до тех пор, пока поток не сообщит cnd_signal или cnd_broadcast, или пока не произойдет ложное пробуждение |
int cnd_timedwait( cnd_t* restrict cond, mtx_t* restrict mutex, const struct timespec* restrict time_point ) |
разблокирует мьютекс, на который указывает mutex, и блокирует переменную условия, на которую указывает cond, до тех пор, пока поток не сообщит cnd_signal или cnd_broadcast, или пока не будет достигнут момент времени, на который указывает time_point, или пока не произойдет ложное пробуждение |
void cnd_destroy(cnd_t* cond); |
уничтожает условную переменную, на которую указывает cond |
int tss_create(tss_t* tss_key, tss_dtor_t destructor) |
создает локальное хранилище потока с заданным деструктором destructor, помещая его идентификатор в переменную, на которую указывает tss_key |
void *tss_get(tss_t tss_key) |
возвращает данные, содержащиеся в локальном хранилище потока, идентифицируемом tts_key |
int tss_set(tss_t tss_id, void *val) |
устанавливает значение, хранящееся в локальном хранилище потока, идентифицируемом tts_key, равным val |
void tss_delete(tss_t tss_id) |
уничтожает локальное хранилище потока, идентифицируемое tts_id |
Ссылки
[править | править код]Примечания
[править | править код]- ↑ ISO/IEC 9899:201x . Дата обращения: 11 июля 2020. Архивировано 29 марта 2018 года.