tss_create
来自 cppreference.cn
| 在头文件 <threads.h> 中定义 |
||
| int tss_create( tss_t* tss_key, tss_dtor_t destructor ); |
(C11 起) | |
创建新的线程局部存储键，并将其存储在 tss_key 指向的对象中。尽管不同的线程可以使用相同的键值，但通过 tss_set 绑定到键的值是按线程维护的，并持续到调用线程的生命周期结束。
在所有现有线程中，新创建的键都关联 NULL 值，并且在线程创建时，所有 TSS 键关联的值都被初始化为 NULL。
如果 destructor 不是空指针，那么当存储被 thrd_exit 释放时（但不是通过 tss_delete，也不是在程序终止时通过 exit），将调用此析构函数。
在线程局部存储析构函数中调用 tss_create 会导致未定义行为。
目录 |
[编辑] 参数
| tss_key | - | 指向内存位置的指针，用于存储新的线程局部存储键 |
| 析构函数 | - | 指向线程退出时调用的函数的指针 |
[编辑] 注意
此函数在 POSIX 中的等价函数是 pthread_key_create。
[编辑] 返回值
如果成功则为 thrd_success，否则为 thrd_error。
[编辑] 示例
| 本节不完整 原因：改进，或许可以参考 POSIX 示例以获取灵感 |
int thread_func(void *arg) { tss_t key; if (thrd_success == tss_create(&key, free)) { tss_set(key, malloc(4)); // stores a pointer on TSS // ... } } // calls free() for the pointer stored on TSS
[编辑] 参考资料
- C17 标准 (ISO/IEC 9899:2018)
- 7.26.6.1 The tss_create function (p: 281-282)
- C11 标准 (ISO/IEC 9899:2011)
- 7.26.6.1 The tss_create function (p: 386)
