命名空间
变体
操作

tss_delete

来自 cppreference.cn
< c‎ | thread
定义于头文件 <threads.h>
void tss_delete( tss_t tss_id );
(自 C11 起)

销毁由 tss_id 标识的线程特定存储。

析构函数(如果通过 tss_create 注册)不会被调用(它们仅在线程退出时被调用,无论是通过 thrd_exit 还是从线程函数返回),程序员有责任确保每个知道 tss_id 的线程在调用 tss_delete 之前执行所有必要的清理。

如果在另一个线程正在为 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_delete 也必须与每个线程同步,即使只是为了检查该线程中此 TSS 的值是否为空(析构函数仅针对非空值调用)。

[编辑] 示例

[编辑] 参考文献

  • C17 标准 (ISO/IEC 9899:2018)
  • 7.26.6.2 tss_delete 函数 (p: 282)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.26.6.2 tss_delete 函数 (p: 386)