Active List

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.