Control.Concurrent.Classy.QSemN

Quantity semaphores in which each thread may wait for an arbitrary "amount".

General Quantity Semaphores

data QSemN m

QSemN is a quantity semaphore in which the resource is aqcuired and released in units of one. It provides guaranteed FIFO ordering for satisfying blocked waitQSemN calls.

The pattern

bracket_ (waitQSemN n) (signalQSemN n) (...)

is safe; it never loses any of the resource.

newQSemN :: MonadConc m => Int -> m (QSemN m)

Build a new QSemN with a supplied initial quantity. The initial quantity must be at least 0.

waitQSemN :: MonadConc m => QSemN m -> Int -> m ()

Wait for the specified quantity to become available

signalQSemN :: MonadConc m => QSemN m -> Int -> m ()

Signal that a given quantity is now available from the QSemN.