Процедура библиотеки API _DBSeek( )

Просматривает индексированную таблицу в текущей рабочей области в поисках пе вой записи, ключ индекса которой соответствует значению val.

Синтаксис

long _DBSeek(Value FAR *val)
Value FAR *val; /* Искомое значение. */

Комментарии

Если программа _DBSeek( ) обнаружит требуемую запись, она перемещает к ней указатель записи и возвращает номер этой записи. Ключ индекса должен в точности совпасть со значением, если только не действует SET EXACT OFF. Если _DBSeek( ) не находит нужной записи, возвращается 0. Если совпадений не выявлено и установка SET NEAR имеет значение ON, указатель записи устанавливается непосредственно после записи, которая больше всех похожа на искомую. Если установка SET NEAR имеет значение OFF, указатель записи устанавливается в конце таблицы.

Если возникает ошибка, _DBSeek( ) возвращает отрицательное целое число, абсо ютное значение которого равно номеру ошибки Visual FoxPro.

При поиске числового поля в качестве val должно быть установлено значение типа (ev_type) 'N', даже если в этом поле ет десятичных цифр. Если val имеет значение типа ev_type 'I', _DBSeek( ) возвратит внутреннюю ошибку с омером 302, "Data type mismatch" [Несоответствие типов данных].