Команда SEEK

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

Синтаксис

SEEK eExpression
[ORDER nIndexNumber | IDXIndexFileName
| [TAG] TagName [OF CDXFileName]
[ASCENDING | DESCENDING]]
[IN nWorkArea | cTableAlias]

Параметры

eExpression

Задает ключ индекса, который ищет команда SEEK. eExpression не может иметь нулевое значение.

ORDER nIndexNumber

Задает номер файла индекса или тега индекса, используемого для поиска ключа ин екса. nIndexNumber указывает файлы индекса в том порядке, в котором они перечислены в команде USE или SET INDEX. Сначала нумеруются открытые файлы .IDX в том порядке, в кото ом они фигурируют в команде USE или SET INDEX. Затем нумеруются теги в файле ст уктурного индекса .CDX (если он существует) в порядке их создания. Наконец, умеруются теги во всех открытых независимых файлах .CDX в порядке их создания. По робнее о нумерации индексов см. описание команды SET ORDER.

ORDER IDXIndexFileName

Задает файл .IDX, который используется при поиске ключа индекса.

ORDER [TAG] TagName [OF CDXFileName]

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

Если в открытых файлах независимых индексов .CDX существуют одинаковые имена тегов, задайте файл .CDX, содержащий нужный тег, с помощью предложения OF CDXFileName.

Замечание Если существуют тег и файл .IDX с одинаковыми именами, приоритет имеет файл .IDX.

ASCENDING

Указывает, что таблица просматривается в возрастающем порядке.

DESCENDING

Указывает, что таблица просматривается в убывающем порядке.

IN nWorkArea

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

IN cTableAlias

Задает псевдоним просматриваемой таблицы.

Если предложения IN nWorkArea и IN cTableAlias опущены, поиск ведется в таблице, принадлежащей выбранной в данный момент ра очей области.

Комментарии

Команду SEEK можно использовать только в индексированных таблицах, и поиск мож о вести только по ключу индекса. Совпадение должно быть точным, если только не действует установка SET EXACT OFF.

Если команда SEEK обнаруживает запись с искомым ключом индекса, функция RECNO( ) возвращает номер этой записи, FOUND( ) возвращает значение "истина" (.T.), а EOF( ) значение "ложь" (.F.).

Если искомый ключ не найден, RECNO( ) возвращает число записей в таблице плюс 1, FOUND( ) возвращает "ложь" (.F.), а EOF( ) возвращает "истину" (.T.).

Если установка SET NEAR имеет значение ON, указатель записи устанавливается с азу после записи с наиболее близким к заданному ключом индекса. Если действует SET NEAR OFF, указатель записи устанавливается в конец файла. В обоих случаях функция RECNO(0) возвращает номер наиболее похожей записи.