pthread_key_delete(3)

pthread_key_delete − スレッド固有のデータキーの削除

Reentrant C Library (libc_r, −pthread)

#include <pthread.h>

int

pthread_key_delete(pthread_key_t key);

解説

pthread_key_delete() 関数は、以前に pthread_key_create() によって返された スレッド固有のデータキーを削除します。 key に関連付けられたスレッド固有の データ値は、 pthread_key_delete() が呼び出される時点で NULL である必要は ありません。全てのアプリケーション記憶領域の解放、または削除されたキーに 関連したデータ構造や全てのスレッドの中のスレッド固有のデータの全てのク リーンアップ動作の実行は、アプリケーションの責務です。このクリーンアップ は pthread_key_delete() が呼び出される前後で実行されることが可能です。 pthread_key_delete() の呼び出しの後で、 key を使用しようとする全ての試み の結果は、不定動作になります。

pthread_key_delete() 関数は、デストラクタ関数の中から呼び出すことが可能で す。デストラクタ関数は、 pthread_key_delete() からは呼び出されません。 key に関連付けられているかもしれない全てのデストラクタ関数は、スレッドの 終了時にはもはや呼び出されません。

問題がない場合は、 pthread_key_delete() 関数は 0 を返します。問題がある場 合は、そのエラーを示すためにエラー番号が返されます。

pthread_key_delete() は以下の場合に失敗します。

key の値が無効です。

関連項目

pthread_getspecific(3), pthread_key_create(3), pthread_setspecific(3)

pthread_key_delete() は ISO/IEC 9945-1:1996 (‘‘POSIX.1’’) に適合していま す。

FreeBSD 10.0 April 4, 1996 FreeBSD 10.0