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)