Функция KEYMATCH( )

Просматривает тег индекса или файл индекса в поисках ключа индекса.

Синтаксис

KEYMATCH(eIndexKey [, nIndexNumber [, nWorkArea | cTableAlias]])

Параметры

eIndexKey

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

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

nIndexNumber

Указывает, в каком именно файле индекса или теге индекса должен вестись поиск. Обычно nIndexNumber является целым числом; сначала он равен 1, а затем наращивается на 1 для пос едовательного просмотра остальных тегов индексов.

Если nIndexNumber равен 1, просматривается главный файл простого индекса .IDX или главный тег и декса (если он имеется).

По мере увеличения nIndexNumber последовательно просматриваются теги структурного составного индекса (если он существует). Теги просматриваются в том порядке, в каком они создавались в ст уктурном составном индексе.

Если nIndexNumber все увеличивается и все теги структурного составного индекса просмотрены, ачинается поиск среди тегов открытых независимых составных индексов. Эти теги п осматриваются в том порядке, в каком они создавались в независимых составных ин ексах.

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

nWorkArea | cTableAlias

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

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

Результат

Логический

Комментарии

Функция KEYMATCH( ) просматривает тег индекса или файл индекса в поисках конк етного ключа индекса и возвращает значение "истина" (.T.), найдя ключ индекса; в противном случае KEYMATCH( ) возвращает "ложь" (.F.). Функцию KEYMATCH( ) мож о использовать для предотвращения дублирования ключей индекса.

Функция KEYMATCH( ) возвращает указатель записи, указывающий на запись, у кото ой он располагался до выдачи функции KEYMATCH( ).