PTHREAD_MUTEX_TRYLOCK(3) |
FreeBSD Library Functions Manual |
PTHREAD_MUTEX_TRYLOCK(3) |
名称
pthread_mutex_trylock —
ブロックせずにミューテックス (mutex) のロックを試みる
ライブラリ
POSIX Threads Library (libpthread, -lpthread)
書式
#include < pthread.h>
int
pthread_mutex_trylock( pthread_mutex_t *mutex);
解説
pthread_mutex_trylock() 関数は、
mutex をロックします。ミューテックス (mutex) が既にロックされているなら、
pthread_mutex_trylock() は、ミューテックスのためのウェート (待ち) をブロックせずに、エラー条件を返します。
戻り値
成功したなら、
pthread_mutex_trylock() は、0 を返し、そうでなければ、エラー番号がエラーを示すために返されます。
エラー
pthread_mutex_trylock() 関数は、次の場合に失敗します:
-
[
EINVAL]
-
mutex によって指定された値が無効です。
-
[
EBUSY]
-
mutex が既にロックされています。
規格
pthread_mutex_trylock() 関数は、 ISO/IEC 9945-1:1996 (“POSIX.1”) に適合しています。