pthread_cond_timedwait

原型：

#include <pthread.h>
 
int pthread_cond_timedwait(pthread_cond_t *restrict cond,
           pthread_mutex_t *restrict mutex,
           const struct timespec *restrict abstime);
int pthread_cond_wait(pthread_cond_t *restrict cond,
           pthread_mutex_t *restrict mutex);

用法：

pthread_cond_timedwait()用于等待一个条件变量，等待条件变量的同时可以设置等待超时。这是一个非常有用的功能，如果不想一直等待某一条件变量，就可以使用这个函数。

demo:

static int XXXX_timeout_wait(pthread_cond_t *cond, pthread_mutex_t *mutex,
                         signed long long timeout) {
  signed long long end_time;
  struct timeval r;
  struct timespec ts;
  int ret;
  pthread_mutex_lock(mutex);
  if (timeout != -1) {
    gettimeofday(&r, NULL);
    end_time = (((((signed long long)r.tv_sec) * 1000000) + r.tv_usec) +
      (timeout / 1000));
    ts.tv_sec  = (end_time / 1000000);
    ts.tv_nsec = ((end_time % 1000000) * 1000);
    ret = pthread_cond_timedwait(cond, mutex, &ts);
  } else {
    ret = pthread_cond_wait(cond, mutex);
  }
  pthread_mutex_unlock(mutex);
  return ret;
}

pthread_cond_signal

pthread_cond_broadcast

用法：

这2个函数会解除在某个条件变量上阻塞的线程的阻塞。

pthread_cond_broadcast()会解除当前所有在某个条件变量上阻塞的线程的阻塞。

pthread_cond_signal()至少解除一个某个条件变量上阻塞的线程的阻塞，如果有任何线程阻塞在条件变量上的话。

如果超过一个以上的线程阻塞在一个条件变量上，调度策略决定了被解除阻塞的线程的顺序。当调用了pthread_cond_broadcast()或者pthread_cond_signal()唤醒线程后，被唤醒的线程要想从pthread_cond_wait()或者pthread_cond_timedwait()返回，首先得获取pthread_cond_wait()或者pthread_cond_timedwait()的互斥锁。解除阻塞的线程会根据调度策略来竞争互斥锁，如同每个都调用了pthread_mutex_lock（）。

线程在调用pthread_cond_broadcast（）或pthread_cond_signal（）函数时，无论它当前是否拥有调用pthread_cond_wait（）或pthread_cond_timedwait（）的线程在等待期间与条件变量相关联的互斥锁; 但是，如果需要可预测的调度行为，调用pthread_cond_broadcast（）或pthread_cond_signal（）的线程应该使用互斥锁锁定。

如果当前没有线程阻塞在条件变量上，那么pthread_cond_broadcast（）或pthread_cond_signal（）函数不应该生成任何效果。

如果成功，pthread_cond_broadcast（）和pthread_cond_signal（）函数将返回零; 否则，应返回错误编号以指示错误。
 

用法：

pthread_cond_init

pthread_cond_wait

pthread_cond_timedwait

pthread_cond_signal

pthread_cond_destroy