pthread_cond_timedwait(3)

pthread_cond_timedwait − 指定した時間の間の条件変数の待機

Reentrant C Library (libc_r, −pthread)

#include <pthread.h>

int

pthread_cond_timedwait(pthread_cond_t *cond, pthread_mutex_t *mutex, const struct timespec *abstime);

解説

pthread_cond_timedwait() 関数は、 cond で指定された条件変数で待っている現 在のスレッドを不可分にブロックし、 mutex で指定された mutex のブロックを 解除します。待っているスレッドは、別のスレッドが pthread_cond_signal(3) または pthread_cond_broadcast(3) を同じ条件変数で呼び出した後、またはシス テム時間が abstime に指定された時間に達した場合、にのみブロックが解除さ れ、現在のスレッドは mutex のロックを再取得します。

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

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

cond, mutex または abstime によって指定された値が無効 です。

[ETIMEDOUT]
システム時間が、 abstime に指定した時間に達しました。 または、超過しました。

関連項目

pthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3), pthread_cond_signal(3), pthread_cond_wait(3)

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

FreeBSD 10.0 July 28, 1998 FreeBSD 10.0