名称

pthread_mutex_init — ミユーテックス (mutex) を作成する

ライブラリ

POSIX Threads Library (libpthread, -lpthread)

書式

#include < pthread.h>

int
pthread_mutex_init( pthread_mutex_t *mutex, const pthread_mutexattr_t *attr);

解説

pthread_mutex_init() 関数は、 attr で指定された属性で、新しいミューテックス (mutex) を作成します。 attr が NULL であるなら、デフォルトの属性が使用されます。

戻り値

成功したなら、 pthread_mutex_init() は、0 を返し、 mutex に新しいミューテック ID を入れます、そうでなければ、エラー番号がエラーを示すために返されます。

エラー

pthread_mutex_init() 関数は、次の場合に失敗します:

[ EINVAL]

attr によって指定された値が無効です。

[ ENOMEM]

プロセスが別のミューテックを作成するための十分なメモリを割り付けることができません。

関連項目

pthread_mutexattr(3), pthread_mutex_destroy(3), pthread_mutex_lock(3), pthread_mutex_trylock(3), pthread_mutex_unlock(3)

規格

pthread_mutex_init() 関数は、 ISO/IEC 9945-1:1996 (“POSIX.1”) に適合しています。