Skip to main content
Version: 20 R7 BETA

New list

New list : ListRef

ParameterTypeDescription
Function resultListRefList reference number

Description

New list creates a new, empty hierarchical list in memory and returns its unique list reference number.

WARNING: Hierarchical lists are held in memory. When you are finished with a hierarchical list, it is important to dispose of it and free the memory, using the command CLEAR LIST.

Several other commands allow you to create hierarchical lists:

  • Copy list duplicates a list from an existing list.
  • Load list creates a list by loading a Choice List created (manually or programmatically) in the Design enviornment List Editor.
  • BLOB to list creates a list from the contents of a BLOB in which a list was previously saved.

After you have created a hierarchical list using New list, you can:

Example

See example for the APPEND TO LIST command.

See also

APPEND TO LIST
BLOB to list
CLEAR LIST
Copy list
DELETE FROM LIST
INSERT IN LIST
LIST TO BLOB
Load list

Properties

Command number375
Thread safe