C 参考手册

位置：首页 > C 参考手册 >线程支持库 > cnd_timedwait

cnd_timedwait

定义于头文件 <threads.h>
int cnd_timedwait( cnd_t* restrict cond, mtx_t* restrict mutex,
                   const struct timespec* restrict time_point );
 (C11 起)

原子地解锁 mutex 所指向的互斥，并在 cond 所指向的条件变量上阻塞，直到线程被 cnd_signal 或 cnd_broadcast 发信号，或直至抵达 time_point 所指向的基于 TIME_UTC 的时间点，或直至虚假唤醒出现。在函数返回前重新锁定该互斥。

若调用方线程未锁定该互斥，则行为未定义。

参数

cond - 指向要在上面阻塞的条件变量的指针
mutex - 指向要在阻塞期间解锁的互斥的指针
time_point - 指向指定等待时限时间的对象的指针

返回值

若成功则为 thrd_success ，若在锁定互斥前抵达时限则为 thrd_timedout ，若出现错误则为 thrd_error 。

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.26.3.5 The cnd_timedwait function (p: 379-380)

参阅

(C11)
 在条件变量上阻塞
(函数)