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