GETLIST, GETLISTV

GETLIST, GETLISTV

Top  Previous  Next

 

The GETLIST statement restores a select list from the $SAVEDLISTS file. The GETLISTV statement is similar but creates a select list variable.

 

 

Format

 

GETLIST name {TO list.no}

{THEN statement(s)}

{ELSE statement(s)}

 

GETLISTV name TO list.var

{THEN statement(s)}

{ELSE statement(s)}

 

where

 

nameis the name of the $SAVEDLISTS entry to be restored.

 

list.nois the select list number to which it is to be restored. If omitted, this defaults to zero.

 

list.varis the select list variable to be created.

 

statement(s)are statements to be executed depending on the outcome of the operation.

 

 

The GETLIST and GETLISTV statements restore the previously saved select list identified by name from the $SAVEDLISTS file. The disk copy is not removed by this operation.

 

The @SELECTED variable can be examined to determine the number of items in the list.

 

At least one of the THEN and ELSE clauses must be present. If the list is successfully restored, the THEN clause is executed. If the list does not exists or cannot be restored for any other reason, the ELSE clause is executed.

 

 

See also:

SAVELIST, WRITELIST