pthread_mutexattr_init(3T)

構文

パラメータ

説明

pthread_mutexattr_init() は、mutex 属性オブジェクト attr のすべての属性を、デフォルト値で初期化します。 属性オブジェクトは、mutex を詳細に説明するものであり、mutex 初期化関数に渡されます。

mutex 属性オブジェクトを使用して mutex を初期化すると、各属性の値によって、新しい mutex の特性が決まります。 属性オブジェクトは、オブジェクト初期化の際の追加パラメータの役割を果たします。 pthread_mutex_init() 関数の呼び出しでは、１ つの属性オブジェクトを何度でも使用することができます。

属性オブジェクトで mutex を初期化すると、属性は mutex の中にコピーされるのと同じことになります。 結果として、属性オブジェクトにどのような変更を加えても、前回初期化された mutex には影響ありません。 特定の属性オブジェクトを必要とするすべての mutex の初期化が済めば、属性オブジェクトは必要ありません。

mutex 属性とそのデフォルト値は、次のとおりです。

初期化済みの mutex 属性オブジェクトを再度初期化すると、動作は不定になります。

pthread_mutexattr_destroy() は、mutex 属性オブジェクト attr を消去します。 消去された mutex 属性オブジェクトは実体が消去され、そのリソースは再生されます。 消去された後で attr を使用した場合、結果は不定です。 mutex 属性オブジェクトは、消去されても関数 pthread_mutexattr_init() で再び初期化できます。

すでに作成済みの mutex は、作成時に使用した mutex 属性オブジェクトを消去しても影響を受けません。

戻り値

正常終了すると、 pthread_mutexattr_init() と pthread_mutexattr_destroy() は ０ を返します。 それ以外の場合、エラーの内容を表すエラー番号を返します (errno 変数は使用しません)。

エラー

以下の条件の場合、 pthread_mutexattr_init() と pthread_mutexattr_destroy() 関数は、該当するエラー番号を返します。

著者

pthread_mutexattr_init() と pthread_mutexattr_destroy() は、IEEE POSIX P1003.1c 規格から派生しました。

参照

pthread_create(3T), pthread_mutexattr_getpshared(3T), pthread_mutexattr_setpshared(3T), pthread_mutexattr_gettype(3T), pthread_mutexattr_settype(3T), pthread_mutex_init(3T)

標準準拠