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

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

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

Возвращает

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

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

Примеры

В таблице "Организации" найдем организацию с указанным "ИНН" и "Кодом филиала". Поиск ведется с конца индекса:

оОрг = Таблица("Организации");
Если(НайтиСКонца(оОрг, "ИНН", "ИНН", "7605015333", "КодФилиала", "4"))
   Сообщить(оОрг.Название);
иначе
   Сообщить("Нет такой организации!");

См. также:

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

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

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