tss_delete

< c‎ | thread
定义于头文件 <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)