标准库头文件 <threads.h> (C11)

 

C

编译器支持

语言

头文件

类型支持

程序工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

标准库头文件

<assert.h> <complex.h> (C99) <ctype.h> <errno.h> <fenv.h> (C99) <float.h> <inttypes.h> (C99)     <iso646.h> (C95) <limits.h> <locale.h> <math.h>

<setjmp.h> <signal.h> <stdalign.h> (C11*) <stdarg.h> <stdatomic.h> (C11)     <stdbit.h> (C23) <stdbool.h> (C99*) <stdckdint.h> (C23) <stddef.h> <stdint.h> (C99) <stdio.h>

<stdlib.h> <stdmchar.h> (C29) <stdnoreturn.h> (C11*) <string.h> <tgmath.h> (C99) <threads.h> (C11) <time.h> <uchar.h> (C11) <wchar.h> (C95) <wctype.h> (C95)

 

此头文件是并发支持库的一部分，并提供对线程、互斥量、条件变量和线程特定存储的支持。

线程

thrd_t	实现定义的完整对象类型，用于标识线程
thrd_create (C11)	创建线程 (函数)
thrd_equal (C11)	检查两个标识符是否引用同一个线程 (函数)
thrd_current (C11)	获取当前线程标识符 (函数)
thrd_sleep (C11)	暂停调用线程的执行，持续给定的时间段 (函数)
thrd_yield (C11)	让出当前时间片 (函数)
thrd_exit (C11)	终止调用线程 (函数)
thrd_detach (C11)	分离线程 (函数)
thrd_join (C11)	阻塞直到线程终止 (函数)
thrd_successthrd_timedoutthrd_busythrd_nomemthrd_error (C11)	指示线程错误状态 (常量)
thrd_start_t (C11)	函数指针类型 int(*)(void*) 的 typedef，由 thrd_create 使用 (typedef)

互斥

mtx_t	互斥量标识符
mtx_init (C11)	创建互斥量 (函数)
mtx_lock (C11)	阻塞直到锁定互斥量 (函数)
mtx_timedlock (C11)	阻塞直到锁定互斥量或超时 (函数)
mtx_trylock (C11)	锁定互斥量，如果已被锁定则立即返回，不阻塞 (函数)
mtx_unlock (C11)	解锁互斥量 (函数)
mtx_destroy (C11)	销毁互斥量 (函数)
mtx_plainmtx_recursivemtx_timed (C11)(C11)(C11)	定义互斥量的类型 (枚举)
调用一次
call_once (C11)	精确地调用函数一次 (函数)

条件变量

cnd_t	条件变量标识符
cnd_init (C11)	创建条件变量 (函数)
cnd_signal (C11)	解除阻塞一个在条件变量上阻塞的线程 (函数)
cnd_broadcast (C11)	解除阻塞所有在条件变量上阻塞的线程 (函数)
cnd_wait (C11)	在条件变量上阻塞 (函数)
cnd_timedwait (C11)	在条件变量上阻塞，带有超时 (函数)
cnd_destroy (C11)	销毁条件变量 (函数)

线程局部存储

thread_local (C11)(在 C23 中移除)	存储类说明符 _Thread_local 的便捷宏 (关键字宏)
tss_t	线程特定存储指针
TSS_DTOR_ITERATIONS (C11)	析构函数被调用的最大次数 (宏常量)
tss_dtor_t (C11)	函数指针类型 void(*)(void*)，用于 TSS 析构函数 (typedef)
tss_create (C11)	创建带有给定析构函数的线程特定存储指针 (函数)
tss_get (C11)	从线程特定存储读取 (函数)
tss_set (C11)	写入线程特定存储 (函数)
tss_delete (C11)	释放给定线程特定指针持有的资源 (函数)

概要

#define __STDC_NO_THREADS__ 202311L
 
#define ONCE_FLAG_INIT      /* see description */
#define TSS_DTOR_ITERATIONS /* see description */
 
typedef /* see description */ cnd_t;
typedef /* see description */ thrd_t;
typedef /* see description */ tss_t;
typedef /* see description */ mtx_t;
typedef /* see description */ tss_dtor_t;
typedef /* see description */ thrd_start_t;
 
#define mtx_plain     /* see description */
#define mtx_recursive /* see description */
#define mtx_timed     /* see description */
#define once_flag     /* see description */
#define thrd_busy     /* see description */
#define thrd_error    /* see description */
#define thrd_nomem    /* see description */
#define thrd_success  /* see description */
#define thrd_timedout /* see description */
 
void call_once(once_flag* flag, void (*func)(void));
int cnd_broadcast(cnd_t* cond);
void cnd_destroy(cnd_t* cond);
int cnd_init(cnd_t* cond);
int cnd_signal(cnd_t* cond);
int cnd_timedwait(cnd_t* restrict cond, mtx_t* restrict mtx,
const struct timespec* restrict ts);
int cnd_wait(cnd_t* cond, mtx_t* mtx);
void mtx_destroy(mtx_t* mtx);
int mtx_init(mtx_t* mtx, int type);
int mtx_lock(mtx_t* mtx);
int mtx_timedlock(mtx_t* restrict mtx, const struct timespec* restrict ts);
int mtx_trylock(mtx_t* mtx);
int mtx_unlock(mtx_t* mtx);
int thrd_create(thrd_t* thr, thrd_start_t func, void* arg);
thrd_t thrd_current(void);
int thrd_detach(thrd_t thr);
int thrd_equal(thrd_t thr0, thrd_t thr1);
[[noreturn]] void thrd_exit(int res);
int thrd_join(thrd_t thr, int* res);
int thrd_sleep(const struct timespec* duration, struct timespec* remaining);
void thrd_yield(void);
int tss_create(tss_t* key, tss_dtor_t dtor);
void tss_delete(tss_t key);
void* tss_get(tss_t key);
int tss_set(tss_t key, void* val);