Applicable release versions: AP, R83
|Description||a list of strings to be used in a subsequent process that handles items one at a time. Generally, but not always, a list contains item-ids for subsequent processing, but a list may actually contain anything. For example, the statement, "select entity" creates a list of item-ids, while the statement, "select entity name" creates a "list" from the contents of each entity item's "name" attribute.
A "list" may be created by any of the list-generating verbs, such as "get-list", "select", "sselect", etc., or by a Pick/BASIC program.
The "end" command may be used to "deactivate" an active list. See "end" for more information on the "double whammy" effect.
sselect entity by name  18281 items selected out of 18281 items. > When this process returns to the TCL prompt, a list is "active". The list may be used by any subsequent process that processes items. sselect entity by name  18281 items selected out of 18281 items. >save-list entity.by.name List 'entity.by.name' in file 'pointer-file' saved. This example creates an active list, which is immediately "saved". Once a list is saved, it may be used repeatedly, until it is manually deleted. sselect entity by name  18281 items selected out of 18281 items. >save-list entity.by.name List 'entity.by.name' in file 'pointer-file' saved. get-list entity.by.name  18281 items selected out of 1 items. >select entity with city "newport beach"  287 items selected out of 2718281 items. A list may also be generated from an "active" list.