kill-task [Function]

Purpose

The kill-task function removes a given task from its queue.

Syntax

kill-task task

Arguments

The task argument is the task which is to be dequeued. The task was originally created when a production fired, or when there was an explicit call to schedule.

Value

This function returns task if the task was scheduled, and nil otherwise.

Remarks

The kill-task function dequeues, but does not destroy, tasks. These tasks may be subsequently performed or rescheduled.

Examples

(setq t1 (schedule (move (fi box1)))) 
(kill-task t1) ==> |TASK|(MOVE |I|BOX1)