list-tasks [Function]

Purpose

The list-tasks function returns the tasks in a specified queue, or in all queues.

Syntax

list-tasks &key priorities

Arguments

The priorities argument specifies the queue(s) to be listed. This argument is either a priority keyword or a list of such keywords. The currently available priorities are :high and :low.

Value

This function returns a list of queues, where each queue contains a priority keyword followed by the tasks scheduled at that priority.

Examples 

(list-tasks) ==> 
    ((:HIGH |TASK|(T1 |I|JOE) |TASK|(T2 |I|SUE))  
     (:LOW |TASK|(T3 |I|JOE))) 
(list-tasks :priorities :low) ==> 
    ((:LOW |TASK|(T3 |I|JOE))) 
(list-tasks :priorities '(:high :low)) ==> 
    ((:HIGH |TASK|(T1 |I|JOE) |TASK|(T2 |I|SUE))  
     (:LOW |TASK|(T3 |I|JOE)))

See Also

Last modified: Jun 1 1995