execute-actions Macro

Summary

Executes in sequence the actions on a given list.

Package

lispworks

Signature

execute-actions (name-or-list &rest keyword-value-pairs) &rest other-args

Arguments

Description

The macro execute-actions executes, in sequence, the actions on the specified list. If the action-list specified by name-or-list does not exist, then this is handled according to the value of *handle-missing-action-list*. Note that name-or-list is evaluated.

If a user-defined execution function was specified when the action list was defined, then it should accept the following arguments:

(action-list other-args &rest keyword-value-pairs)

Note that other-args is passed as a single list.

If a user-defined execution function was not specified when the action list was defined, then the following default mapping occurs. Each action's data is invoked via apply on other-args:

(apply data other-args)

This behavior is modified by keyword-value-pairs, thus:

• If the keyword parameter :ignore-errors-p is non-nil, any otherwise-unhandled errors signaled inside the execution of that function will be trapped, and a warning issued. Execution continues with the next action-item. If :ignore-errors-p is nil (or not specified), then the error is not trapped.
• If the keyword parameter :post-process is non-nil, the first value returned by each action is handled, according to :post-process, thus:

  :collect	Collect values into list.
  :and	Return t only if all values are t. Return nil immediately if any value is nil.
  :or	Return first non-nil value.

See also

define-action
with-action-list-mapping