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.

See Also

.readnext Command, .readnext null Command, compare-list Command, copy-list Command, Data Representation, delete-list Command, edit-list Command, end Command, execute Statement, fdk Command, fi Command, fl Command, get-list Command, indexer Command, iselect Command, loop Statement, nselect Command, Primary List, readnext Statement, rmbi Command, run-list Command, save Command, save-list Command, Secondary List, select Command, select Statement, sreformat Command, sselect Command, system() Function, tcl Statement, u1195 User Exit, verify-system Command