Функция SEEK( )

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

Синтаксис

SEEK(eExpression [, nWorkArea | cTableAlias
[, nIndexNumber | cIDXIndexFileName | cTagName]])

Параметры

eExpression

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

nWorkArea

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

cTableAlias

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

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

nIndexNumber

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

cIDXIndexFileName

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

cTagName

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

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

Результат

Логический

Комментарии

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

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

Если аргументы nIndexNumber, IDXIndexFileName и cTagName опущены, SEEK( ) использует для поиска ключа индекса главный управляющий ин екс или тег.