tss_create

新しいスレッドローカルストレージのキーを作成し、それを tss_key の指すオブジェクトに格納します。 異なるスレッドで同じキー値を使用することができますが、 tss_set によってキーに束縛される値は、スレッドごとに管理され、呼び出し元スレッドの生存期間の間、存続します。

すべての既存のスレッドにおいて、新たに作成されたキーには値 NULL が紐付けられます。 スレッド作成時、すべての TSS キーに紐付けられた値は 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)); // stores a pointer on TSS
        // ...
    }
} // calls free() for the pointer stored on TSS

参考文献