D3 Reference Manual

Index | Help

Поиск по страницам

Разделы / Общие сведения / active-list

active-list

Активный список

Список строк, который будет использоваться в каком-либо последующем процессе, обрабатывающем записи одну за другой. Обычно, хотя и не всегда, список содержит идентификаторы записей для последующей обработки, но в действительности он может содержать любую информацию. Например, команда "select entity" создает список идентификаторов записей , а команда "select entity name" создает "список", в который входит содержимое атрибута "name" каждой записи файла "entity".

Список может быть создан с помощью любой из команд, генерирующих списки ("get-list", "select", "sselect" и т.д.) или с помощью программы на языке FlashBASIC. Для прекращения работы с активным списком можно использовать команду "end". Более подробную информацию по побочным эффектам см. в описании "end".

Примеры:

sselect entity by name
[404] 2718281 items selected out of 2718281 items.
>

Когда процесс возвращает управление TCL, список "активен". Он может быть использован любым последующим процессом, обрабатывающим записи.

sselect entity by name
[404] 2718281 items selected out of 2718281 items.
>save-list entity.by.name
List 'entity.by.name' in file 'pointer-file' saved.

В этом примере создается активный список, который немедлено записывается в файл "pointer-file", о чем выдается сообщение. После записи списка в файл он может использоваться многократно до тех пор, пока не будет удален.

sselect entity by name
[404] 18281 items selected out of 2718281 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 18281 items.

Из "активного" списка может быть создан новый список.