Функция FOR( )

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

Синтаксис

FOR([nIndexNumber [, nWorkArea | cTableAlias]])

Параметры

Если никакие параметры не заданы, функция FOR( ) возвращает выражение фильтра ля главного файла индекса или тега индекса. Если главного файла индекса или тега индекса нет (например, вы выдали команду SET ORDER TO, чтобы расположить записи в таблице в естественном порядке), FOR( ) возвращает пустую строку.

nIndexNumber

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

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

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

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

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

nWorkArea

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

Если в заданной рабочей области нет открытых таблиц, FOR( ) возвращает пустую строку.

cTableAlias

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

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

Результат

Символьный

Комментарии

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

Каждая из команд USE и SET INDEX поддерживает список имен файлов индексов, который дает возможность открывать для одной таблицы несколько файлов индексов. В тот список можно включать имена файлов простых индексов, имена файлов структур ых составных или независимых составных индексов в любых сочетаниях. Функция FOR( ) идентична функции SYS(2021) и предусмотрена для совместимости с dBASE IV.