The SCL Debugger

PUTLIST

Displays the contents of an SCL list

Syntax
Details
Examples
See Also

Syntax

PUTLIST <arg-list | n>

arg-list

contains one or more SCL list identifiers that are returned by the MAKELIST or COPYLIST function. Use the form <entry-name\ > variable:

entry-name\: is a catalog entry that contains the program that uses variable.
variable: is the variable that contains a list identifier.

n

is one or more numeric literals that represent the list to be printed.

Details

The PUTLIST command displays the contents of an SCL list in the debugger MESSAGE window. The list starts with a left parenthesis, (, to mark its beginning, followed by the list of items separated by blanks. Each named item is preceded by its name and an equal sign, =, but nothing is printed before items that do not have names. The PUTLIST function ends the list with a right parenthesis, ), followed by the list's identifier number within square brackets.

If a list appears more than once in the list being printed, the PUTLIST command displays (...) listid for the second and subsequent occurrences of the list. You should scan the output of the PUTLIST command for another occurrence of listid to view the full contents of the list. This prevents infinite loops if a list contains itself as a sublist.

Examples

Print the contents of List A, which contains the numbers 17 and 328 and the character string 'Any string':
```
DEBUG > putlist a
```
This produces the following output:
```
 ( 17
  328
  'Any string'
  )[5]
```
Print the list identified by number 5 (the same list shown in the previous example):
```
DEBUG> putlist 5
```
This produces the following output:
```
( 17
  328
  'Any string'
  )[5]
```

Print the list identified by the dot notation object.dropoperations, assuming that dropoperations is a valid list attribute on the object identified by object:

putlist object.dropoperations
( COPY=( POPMENUTEXT='Copy here'
         ENABLED='Yes'  
         METHOD='_drop' 
        )[11601]   
  MOVE=( POPMENUTEXT='Move here'  
         ENABLED='No'   
         METHOD='_drop' 
        )[11599]   
  LINK=( POPMENUTEXT='Link here'  
         ENABLED='No'  
         METHOD='_drop'
        )[11597]  
 )[11593]