Иллюстрированный самоучитель по языку системы 1С:Предприятие › Работа с базами данных формата DBF › Методы объекта XBase [страница - 1133] | Самоучители по бухгалтерским программам

Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы объекта XBase

Найти

Найти запись по индексу.

Синтаксис:

Найти(<Ключ>, <Режим>)

Англоязычный синоним:

Find

Параметры:

<Ключ>

Строковое выражение со значением выражения текущего индекса.

<Режим>

Числовое выражение. Режим поиска записей:

0 – ищет запись на точное соответствие ключу (=);
1 – ищет запись на точное соответствие с ключом или большую (>=);
2 – ищет запись с большим ключом (>);
-1 (минус единица) – ищет запись на точное соответствие с ключом или меньшую(<=);
-2 (минус два) – ищет запись с меньшим ключом (<).

Возвращаемое значение:

Число: 1 – если действие выполнено (запись найдена); 0 – если действие не выполнено.

Описание:

Метод Найти позволяет найти запись, соответствующую данному значению <Ключ> ключа по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись.

Следует отметить, что вычисление значения индекса при работе XBase-объекта с базой данных производится объектом самостоятельно на основании выражения, переданного ему при создании ключа (см. описание метода ДобавитьИндекс). При вызове данного метода значение <Ключ> должно быть вычислено средствами встроенного языка, что может представлять определенные трудности, если индекс составной, поля, включенные в выражение индекса, отличны от строковых, и т. д. Поэтому применимость данного метода ограничена случаем использования простых строковых выражений индекса. В более сложных случаях следует применять универсальный метод НайтиПоКлючу.

Пример:

ЗаписьНайдена = ДБФ.Найти("Иванов", 0);