tss_delete

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

并发支持库

线程 thrd_create thrd_equal thrd_current    thrd_sleep thrd_yield thrd_exit thrd_detach thrd_join thrd_successthrd_timedoutthrd_busythrd_nomemthrd_error    原子操作 atomic_init ATOMIC_VAR_INIT (C23 前) ATOMIC_***_LOCK_FREE atomic_is_lock_free atomic_store atomic_load atomic_exchange atomic_compare_exchange atomic_fetch_add atomic_fetch_sub atomic_fetch_or atomic_fetch_xor atomic_fetch_and

原子标志 atomic_flag ATOMIC_FLAG_INIT atomic_flag_test_and_set atomic_flag_clear 内存顺序 memory_order kill_dependency atomic_thread_fence atomic_signal_fence 互斥 mtx_init mtx_lock mtx_timedlock mtx_trylock call_once mtx_unlock mtx_destroy mtx_plainmtx_recursivemtx_timed 条件变量 cnd_init cnd_signal cnd_broadcast cnd_wait cnd_timedwait cnd_destroy 线程局部存储 thread_local TSS_DTOR_ITERATIONS    tss_create tss_get tss_set 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 也必须与每个线程同步（仅对非空值调用析构器）。

引用

• C17 标准（ISO/IEC 9899:2018）：

• 7.26.6.2 The tss_delete function （第 282 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.26.6.2 The tss_delete function （第 386 页）