Возвращается выражение фильтра для открытого простого индекса (single-entry index) (.idx), или выражение фильтра индекса для тэга в комбинированном индексном файле (.cdx).

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

Параметры

nIndexNumber

Определяет числовое выражение nIndexNumber как номер открытого индексного файла, для которого функция SYS(2021) определяет выражение фильтра индекса; nIndexNumber изменяется от 1 - до общего количества открытых простых индексов (single-entry .idx), тэгов в структурных комбинированных индексных файлах, и тегов в независимых составных индексных файлах. (N1+N2+N3)

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

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

  3. В последнюю очередь возвращаются выражения для Тэгов независимого индексного файла; порядок определяется очередностью создания Тэгов.

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

nWorkArea

Определяет номер рабочей области, в которой открыта таблица

cTableAlias

Определяет алиас таблицы. Если задан отсутствующий алиас (таблица закрыта) система Visual FoxPro генерирует Ошибку.

Expand imageВозвращаемое значение

Символьное

Expand imageКомментарии

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

Возвращается пустая строка для простых индексов или Тэгов, которые созданы без использования опции FOR .

Обе Команды: USE и SET INDEX поддерживают сервис указания списка индексных файлов; данный список может быть указан в любой комбинации: простые индексы, структурные составные, независимые составные индексные файлы. 

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

Expand imageСм. также