Найти – по значению индекса

Ищет в таблице запись с начала по указанному значению ключевого поля индекса.

Синтаксис

Найти(Объект, ИмяИндекса, ЗначениеКлючевогоПоля)
Найти(Объект, ИмяИндекса, ИмяКлючевогоПоля1, Значение1[, ИмяКлючевогоПоля2, Значение2………])

Параметры

Объект (объект) – объект, содержащий запись. В случае успешного поиска сюда будет извлечена найденная запись.

Если объект на момент вызова функции содержит запись, ещё не извлеченную из базы данных, то в этой записи должны быть установлены ключевые поля. По значениям, указанным в ключевых полях, и будет вестись поиск.

Если же объект содержит запись, уже извлечённую из базы данных, то берётся по указанному индексу следующая запись.

ИмяИндекса (текст) – имя индекса. Именно индексом определяется, по каким полям и в какой последовательности будет искаться запись. Список индексов каждой таблицы можно посмотреть, открыв соответствующий словарь данных (файл с расширением ".dic") и выбрав нужную таблицу. Там же можно посмотреть и список полей, входящих в каждый из индексов.

ЗначениеКлючевогоПоля (текст) – значение ключевого поля индекса.

ИмяКлючевогоПоля1, ИмяКлючевогоПоля1,... (текст) - имена ключевых полей индекса.

Значение1, Значение2,... (текст) – значения ключевых полей индекса.

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

Возвращает

Да (логическое значение) – найдена запись с указанными значениями ключевых полей. Найденная запись устанавливается в объекте, указанном при вызове функции.

Нет (логическое значение) – нужная запись не найдена. В этом случае запись в объекте инициализируется нулевыми значениями (становится "пустой").

Примеры

В таблице "Правила операций" найдем операцию по индексу "Имя" с указанным значением ключевого поля "СверНалБух":

оОбъект = Таблица("Правила операций");
Если(Найти(оОбъект, "Имя", "СверНалБух"))
    Сообщить(оОбъект.Операция);
Иначе
    Сообщить("Не нашли!");

См. также:

•  НайтиСКонца – по значению индекса

•  Найти – по индексу

•  НайтиСКонца – по индексу