active.list
A list of strings delimited by attribute marks created by one of the list-generating processes.
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.
Example
sselect entity by name
[404] 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
[404] 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
[404] 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
[404] 18281 items selected out of 1 items.
>select entity with city 'newport beach'
[404] 287 items selected out of 2718281 items.
A list may also be generated from an 'active' list.
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.