Waits for a given condition-variable to be signaled.
The function condition-variable-wait waits at most timeout seconds for the condition-variable condvar to be signaled. The lock lock is released while waiting and claimed again before returning. The caller must be holding the lock lock before calling this function.
The return value wakep is non-nil if the signal was received or nil if there was a timeout. If timeout is nil, condition-variable-wait waits indefinitely.
If wait-reason is non-nil, it is used as the wait-reason while waiting for the signal.
It is recommended that you use lock-and-condition-variable-wait or simple-lock-and-condition-variable-wait instead of condition-variable-wait. The locking functions make it easier to avoid mistakes, and can be more efficient.
timeout controls how long to wait for the signal: before returning, the function waits to claim lock, possibly indefinitely.
condition-variable-wait-count
make-condition-variable
lock-and-condition-variable-wait
simple-lock-and-condition-variable-wait
lock-and-condition-variable-signal
lock-and-condition-variable-broadcast
condition-variable-signal
condition-variable-broadcast
Condition variables
LispWorks User Guide and Reference Manual - 20 Sep 2017