Macro

Summary

Executes a body of code while holding a lock.

Package

mp

Signature

with-lock (lock &optional whostate timeout) &body body => result

Arguments

lock

The lock.

whostate

The status of the process while the lock is locked, as seen in the Process Browser.

timeout

A timeout period, in seconds.

body

The forms to execute.

Values

result

The result of executing body.

Description

with-lock executes body while holding the lock, and unlocks the lock when body exits. This is the recommended way of using locks. The value of body is returned normally. body is not executed if the lock could not be claimed, in which case, with-lock returns nil.

See also

make-lock
process-lock
process-unlock
with-exclusive-lock
with-sharing-lock