process-property Accessor

Summary

Gets and sets a general property for a process.

Package

mp

Signature

process-property indicator &optional process default => value

setf (process-property indicator &optional process default) value => value

Arguments

indicator⇩	A Lisp object.
process⇩	A process.
default⇩	A Lisp object.
value⇩	A Lisp object.

Values

value⇩

A Lisp object.

Description

The accessor process-property gets or sets the value that is associated with indicator for the process process.

If process is not supplied or is nil, the current process (that is, the result of calling get-current-process) is used.

If indicator is not associated with a value in the properties, process-property returns default.

(setf process-property) overwrites any existing value for indicator to value and default is ignored.

The default value of default is nil.

Notes

In the typical case when only the current process sets the property (even if other processes read it), private properties can be used, and are much faster in SMP LispWorks, because they do not need to deal with parallel setting. See process-private-property.

Examples

(process-property 'foo (get-current-process) 'bar)

=> BAR

(setf (process-property 'foo) 'foo-value)
=> FOO-VALUE

(process-property 'foo)

=> FOO-VALUE

See also

process-private-property
remove-process-property
remove-from-process-property
pushnew-to-process-property