SYS(2021) - выражение фильтра индекса

Возвращает выражение фильтра для открытого файла простого индекса (.IDX) или в ражения фильтра для тегов в файлах составного индекса (.CDX).

Синтаксис

SYS(2021, nIndexNumber [, nWorkArea | cTableAlias])

Результат

Символьный

Параметры

nIndexNumber

Числовое выражение nIndexNumber определяет, какое выражение фильтра необходимо возвратить из открытых файлов индексов. Функция SYS(2021) возвращает выражения фильтра по мере увеличения з ачения nIndexNumber от 1 до общего количества открытых файлов простых индексов .IDX и тегов ст уктурных составных и независимых составных индексов в следующем порядке:

1. Сначала возвращаются выражения фильтра из файлов простых индексов .IDX (если с еди них есть открытые). Они возвращаются в том порядке, в каком файлы простых индексов .IDX задавались в командах USE или SET INDEX.

2. Затем возвращаются выражения фильтра для каждого тега файла структурного ин екса .CDX (если он имеется). Они возвращаются из тегов в том порядке, в каком теги создавались в структурном индексе.

3. Наконец, возвращаются выражения фильтра для каждого тега во всех открытых фай ах независимых индексов .CDX. Выражения фильтра возвращаются из тегов в том по ядке, в каком теги создавались в независимых составных индексах.

Если nIndexNumber больше общего числа открытых файлов простых индексов .IDX и тегов структурных и независимых индексов .CDX, возвращается пустая строка.

nWorkArea

Задает номер рабочей области для таблицы, открытой в другой рабочей области.

cTableAlias

Задает псевдоним таблицы, открытой в другой рабочей области. Если у таблицы ет заданного псевдонима, Visual FoxPro выдает сообщение об ошибке.

Комментарии

В Visual FoxPro можно создавать отфильтрованные индексы. Если в команде INDEX задать необязательное предложение FOR, файл индекса выступает в роли фильтра по отношению к таблице. Вы сможете отображать и обрабатывать только записи, соответствующие выражению фильтра lExpression в предложении FOR. Ключи индекса создаются в файле индекса только для записей, отвечающих выражению индекса.

Если индекс или тег индекса создан без помощи предложения FOR, возвращается пустая строка.

Как команда USE, так и команда SET INDEX поддерживает список имен файлов ин ексов, благодаря чему для таблицы можно открыть несколько файлов индексов. В этот список можно включать имена файлов простых индексов .IDX, структурных индексов .CDX и независимых индексов .CDX в любых сочетаниях.

Функция SYS(2021) возвращает выражения фильтра из файлов индексов, открытых в текущей рабочей области, если только вы не задали конкретную рабочую область и и псевдоним.