tss_create

新しいスレッド固有ストレージキーを作成し、それを tss_key が指すオブジェクトに格納します。 同じキー値が異なるスレッドで使用される場合でも、 tss_set によってキーにバインドされた値はスレッドごとに維持され、呼び出しスレッドのライフタイムを通じて持続します。

値 NULL は新しく作成されたキーに関連付けられ、すべての既存スレッドで有効です。また、スレッド作成時には、すべてのTSSキーに関連付けられた値は NULL に初期化されます。

destructor がnullポインタでない場合、 destructor も関連付けられ、このデストラクタはストレージが thrd_exit によって解放されるときに呼び出されます（ただし、 tss_delete による場合や、 exit によるプログラム終了時には呼び出されません）。

スレッド固有ストレージのデストラクタ内での tss_create の呼び出しは未定義動作を引き起こします。

パラメータ

注記

この関数の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)); // TSSにポインタを格納
        // ...
    }
} // TSSに格納されたポインタに対してfree()を呼び出す

参考文献