C 参考手册
- C 语言
- C 关键词
- 预处理器
- C 标准库头文件
- 类型支持
- 程序支持工具
- 变参数函数
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 算法
- 数值
- 文件输入/输出
- 本地化支持
- 原子操作库
- 线程支持库
- thread_local
- thrd_create
- thrd_equal
- thrd_current
- thrd_sleep
- thrd_yield
- thrd_exit
- thrd_detach
- thrd_join
- thrd_success, thrd_timedout, thrd_busy, thrd_nomem, thrd_error
- mtx_init
- mtx_lock
- mtx_timedlock
- mtx_trylock
- call_once, once_flag, ONCE_FLAG_INIT
- mtx_unlock
- mtx_destroy
- mtx_plain, mtx_recursive, mtx_timed
- cnd_init
- cnd_signal
- cnd_broadcast
- cnd_wait
- cnd_timedwait
- cnd_destroy
- TSS_DTOR_ITERATIONS
- tss_create
- tss_get
- tss_set
- tss_delete
- 实验性 C 标准库
- 有用的资源
- 符号索引
- 注释
tss_delete
定义于头文件 <threads.h>
|
||
void tss_delete( tss_t tss_id ); |
(C11 起) | |
销毁 tss_id
所标识的线程特定存储。
若以 tss_create 注册了一个析构器,则不调用它(仅在线程退出时调用,无论是由 thrd_exit 还是通过从线程函数返回)。程序员负责确保在调用 tss_delete
前,每个知晓 tss_id
的线程都进行了必要的清理。
若在另一线程执行 tss_id
的析构器时调用 tss_delete
,则这是否会更改关联析构器的调用次数是未指定的。
若在调用方线程执行析构器时调用 tss_delete
,则与 tss_id
关联的析构器将不会在此线程上再次执行。
参数
tss_id | - | 先前 tss_create 所返回,且仍未被 tss_delete 删除的线程特定存储关键 |
返回值
(无)
注意
此函数的 POSIX 等价版本是 pthread_key_delete 。
tss_delete
决不调用析构器,是因为正常情况下,有意令原先设置析构器所将处理的值(经由 tss_set )的同一线程执行(线程退出时调用)析构器,而且析构器甚至可能依赖该线程所见的该值或其他线程特定数据。执行 tss_delete
的线程对其他线程的 TSS 无访问权限。即使可能对每个线程的与 tss_id
关联的值调用析构器,若仅为检验该线程中此 TSS 的值是否为空, tss_delete
也必须与每个线程同步(仅对非空值调用析构器)。
示例
本节未完成 原因:暂无示例 |
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.26.6.2 The tss_delete function (p: 386)