pthread_rwlock_destroy() - 読み取りまたは書き込みロック・オブジェクトの破棄

標準

標準/拡張機能 C/C++ 依存項目

z/OS UNIX
Single UNIX Specification、バージョン 3

両方

POSIX(ON)
OS/390 V2R7

形式

#define _OPEN_THREADS
#include <pthread.h>

int pthread_rwlock_destroy(pthread_rwlock_t *rwlock);
SUSV3:
#define _UNIX03_THREADS
#include <pthread.h>

int pthread_rwlock_destroy(pthread_rwlock_t *rwlock);

機能説明

pthread_rwlock_destroy() 関数は、rwlock で識別される読み取りまたは書き込み ロック・オブジェクトを削除し、この読み取りまたは書き込みで使用されていたリソースをすべて 解放します。読み取り/書き込みロックは、共用リソースを保護する場合に使用されます。

注: rwlock は pthread_rwlock_destroy() によって無効値に 設定されますが、pthread_rwlock_init() を使用して再初期化することができます。

戻り値

正常に実行された場合、pthread_rwlock_destroy() は 0 を戻します。

正常に実行されなかった場合、pthread_rwlock_destroy() は -1 を戻して、errno を次のいずれかの 値に設定します。

エラー・コード
説明
EBUSY
rwlock によって参照されたオブジェクトがロックされている、あるいは条件変数で待機の一部として参照されているときに、そのオブジェクト を破棄しようとしました。
EINVAL
rwlock によって指定された値は無効です。

Single UNIX Specification、バージョン 3 の特殊な動作: 正常に実行されなかった場合、pthread_rwlock_destroy() はエラーを示すエラー番号を戻します。

関連情報