SYS(14) - выражение индекса

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

Синтаксис

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

Результат

Символьный

Параметры

nIndexNumber

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

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

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

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

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

nWorkArea | cTableAlias

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

Комментарии

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

Подробнее о выражениях индекса и создании файлов и тегов индексов см. описание команды INDEX. SYS(14), аналогичной функции KEY( ).

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