Acquires units from a semaphore.
mp
semaphore-acquire sem &key timeout wait-reason count => flag
sem⇩ |
A semaphore. |
timeout⇩ |
A non-negative real or nil . |
wait-reason⇩ |
A string or nil . |
count⇩ |
A non-negative fixnum. |
flag |
A generalized boolean. |
The function semaphore-acquire
acquires count units from the semaphore sem.
It attempts to atomically decrement the semaphore's unit count by count. If this gives a non negative result, then it changes the semaphore's unit count accordingly and returns true. The default value of count is 1.
However, if decrementing the semaphore's unit count would result in a negative number then semaphore-acquire
waits until the semaphore's unit count is larger than count and tries again. If wait-reason is true, then it is used as the thread's wait-reason when waiting for the semaphore.
If timeout is nil
, semaphore-acquire
can wait forever. Otherwise, if the semaphore count cannot be decremented within timeout seconds, then semaphore-acquire
returns false and the semaphore is unaffected. Pass timeout 0 if you do not want to wait at all.
You can get the current unit count of a semaphore by calling semaphore-count.
semaphore
make-semaphore
semaphore-count
semaphore-release
semaphore-wait-count
19.7.3 Counting semaphores
LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:30:51