Описание встроенного языка системы 1С Предприятие

Найти


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

Синтаксис:

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

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

Find

Параметры:



<Ключ>

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

<Режим>

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

0 — ищет запись на точное соответствие ключу (=);

1 — ищет запись на точное соответствие с ключом или большую (>=);

2 — ищет запись с большим ключом (>);

-1 (минус единица) — ищет запись на точное соответ­ствие с ключом или меньшую(<=);

-2 (минус два) — ищет запись с меньшим ключом (<).

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

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

Описание:

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

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

Пример:

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



Содержание раздела