tss_create

 

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> 中定義
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。

示例

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)