An active list is a list of strings for use in a subsequent process that handles items one at a time. Typically, a list contains item-IDs for subsequent processing, but a list can 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 can be created by any of the list-generating commands, such as get-list, select, sselect, and so on, or by a FlashBASIC program.
The end command can be used to deactivate an active list.
Once a list is active, the next command issued at TCL must be a valid list-processing command, otherwise the list is deactivated. For example:
The active list has been released.
:sselect entity by name [404] 2718281 items selected out of 2718281 items.
>time 06:44:22 19 Jan 2002 Saturday |
When this process returns to the TCL prompt, a list is active. The list can be used by any subsequent process that processes items.
:sselect entity by name [404] 18281 items selected out of 18281 items.
> |
This example creates an active list, which is immediately saved. Once a list is saved, it can 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. |
A list can also be generated from an active list.
: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. |
See Also