PTHREAD_COND_WAIT(3) BSD Library Functions Manual PTHREAD_COND_WAIT(3)NAMEpthread_cond_wait — wait on a condition variable
SYNOPSIS
#include <pthread.h>
int
pthread_cond_wait(pthread_cond_t *restrict cond,
pthread_mutex_t *restrict mutex);
DESCRIPTION
The pthread_cond_wait() function atomically unlocks the mutex and blocks
the current thread on the condition specified by the cond argument. The
current thread unblocks only after another thread calls
pthread_cond_signal(3) or pthread_cond_broadcast(3) with the same condi‐
tion variable. The mutex must be locked before calling this function,
otherwise the behavior is undefined. Before pthread_cond_wait() returns
to the calling function, it re-acquires the mutex.
RETURN VALUES
If successful, the pthread_cond_wait() function will return zero; other‐
wise, an error number will be returned to indicate the error.
ERRORSpthread_cond_wait() will fail if:
[EINVAL] The value specified by cond or the value specified by
mutex is invalid.
SEE ALSOpthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3),
pthread_cond_signal(3), pthread_cond_timedwait(3)STANDARDSpthread_cond_wait() conforms to ISO/IEC 9945-1:1996 (“POSIX.1”).
Darwin November 5, 2001 Darwin