lock-and-condition-variable-broadcast

lock-and-condition-variable-broadcast Function

Summary

Locks, applies a setup function, calls condition-variable-broadcast and unlocks.

Package

Signature

lock-and-condition-variable-broadcast lock condvar lock-timeout setup-function &rest args => signaledp

Arguments

`lock`⇩	A lock.
`condvar`⇩	A condition-variable.
`lock-timeout`⇩	A non-negative real or `nil`.
`setup-function`⇩	A function designator.
`args`⇩	Arguments to `setup-function`.

Values

signaledp

A generalized boolean.

Description

The function lock-and-condition-variable-broadcast locks the lock lock, applies the function setup-function to args, calls condition-variable-broadcast with condvar and unlocks lock. lock-and-condition-variable-broadcast makes it easier to avoid mistakes when using a condition-variable.

If lock-timeout is non-nil, then lock-and-condition-variable-broadcast returns nil if lock cannot be locked within lock-timeout seconds.

lock-and-condition-variable-broadcast performs the equivalent of:

(mp:with-lock (lock nil lock-timeout)
  (apply setup-function args)
  (mp:condition-variable-broadcast condvar))

It returns the result of the call to condition-variable-broadcast.

See condition-variable-broadcast and with-lock for more details.

Notes

setup-function is called with lock held, so it should do the minimum amount of work and avoid locking other locks.