Как найти строку в таблице значений в 1С

Таблица значений — один из самых используемых объектов во встроенном языке 1С: в ней хранятся данные документов, результаты запросов, промежуточные расчёты. Практически в каждом модуле рано или поздно возникает задача найти строку по значению колонки — например, подобрать строку с нужной номенклатурой или проверить, есть ли уже запись с заданным контрагентом.

Во встроенном языке для этого существуют два основных метода: Найти(), который возвращает одну строку или Неопределено, и НайтиСтроки(), который возвращает массив всех подходящих строк. Дополнительно поиск можно выполнить перебором в цикле, когда условие сложнее простого сравнения на равенство.

Ниже разобраны оба метода с примерами кода, поиск по нескольким условиям, проверка результата, типичные ошибки и ограничения, о которых стоит знать перед тем, как писать обходы в цикле.

Метод Найти: поиск одной строки по значению колонки

Метод Найти() ищет первую строку, в которой указанная колонка равна переданному значению. Синтаксис: ТЗ.Найти(ИскомоеЗначение, ИмяКолонки). Имя колонки передаётся строкой, при необходимости можно указать несколько колонок через запятую — тогда поиск пойдёт последовательно по каждой из них.

НайденнаяСтрока = ТаблицаТоваров.Найти(НоменклатураСсылка, "Номенклатура");

Если НайденнаяСтрока = Неопределено Тогда
Сообщить("Строка с такой номенклатурой не найдена");
Иначе
НайденнаяСтрока.Количество = НайденнаяСтрока.Количество + 1;
КонецЕсли;

Ключевой момент: если строка не найдена, метод возвращает Неопределено, а не вызывает ошибку. Поэтому обращаться к полям результата можно только после проверки. Обращение НайденнаяСтрока.Количество без проверки при отсутствии строки приведёт к ошибке «Поле объекта не обнаружено».

Если второй параметр (имя колонки) не указан, поиск выполняется по всем колонкам таблицы. Так делать не стоит без необходимости: это медленнее и может дать неожиданный результат, если искомое значение встречается в другой колонке раньше.

Метод НайтиСтроки: поиск по одному или нескольким условиям

Метод НайтиСтроки() принимает структуру отбора и возвращает массив всех строк, удовлетворяющих условиям. Это основной инструмент, когда нужно найти несколько строк или отбирать сразу по двум и более колонкам.

ПараметрыОтбора = Новый Структура;
ПараметрыОтбора.Вставить("Номенклатура", НоменклатураСсылка);
ПараметрыОтбора.Вставить("Склад", СкладСсылка);

НайденныеСтроки = ТаблицаТоваров.НайтиСтроки(ПараметрыОтбора);

Для Каждого СтрокаТовара Из НайденныеСтроки Цикл
СтрокаТовара.Количество = СтрокаТовара.Количество + 1;
КонецЦикла;

Условия в структуре объединяются по «И»: строка попадёт в результат, только если совпадут значения всех перечисленных колонок. Если подходящих строк нет, метод вернёт пустой массив — проверка выполняется через НайденныеСтроки.Количество() = 0.

Компактная форма записи той же структуры: Новый Структура("Номенклатура, Склад", НоменклатураСсылка, СкладСсылка). Порядок значений должен соответствовать порядку имён колонок.

Отбор = Новый Структура("Контрагент, Договор", КонтрагентСсылка, ДоговорСсылка);
Строки = ТаблицаОплат.НайтиСтроки(Отбор);
Если Строки.Количество() > 0 Тогда
    СуммаОплат = Строки[0].Сумма;
КонецЕсли;

Поиск через цикл: когда методов недостаточно

Оба штатных метода работают только на строгое равенство. Если условие сложнее — сравнение «больше/меньше», поиск по подстроке, проверка по вычисляемому выражению — придётся использовать обычный перебор в цикле.

Для Каждого СтрокаТовара Из ТаблицаТоваров Цикл
Если СтрокаТовара.Сумма > 100000
И СтрНайти(СтрокаТовара.Наименование, "услуга") > 0 Тогда
// строка удовлетворяет сложному условию
КонецЕсли;
КонецЦикла;

Для поиска одной строки в цикле не забывайте команду Прервать после нахождения — иначе обход продолжится до конца таблицы впустую. Для поиска по подстроке используйте функцию СтрНайти(), которая возвращает позицию вхождения или 0.

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

Ускорение поиска: индексы таблицы значений

Если поиск по одной и той же колонке выполняется многократно — например, внутри цикла обхода другой таблицы — имеет смысл добавить индекс. Это делается одной строкой: ТаблицаТоваров.Индексы.Добавить("Номенклатура").

После добавления индекса методы Найти() и НайтиСтроки() по этой колонке начинают работать существенно быстрее. Индекс поддерживается автоматически при добавлении и удалении строк, поэтому дополнительный код сопровождения не нужен.

Индекс оправдан, когда поисков много. Для однократного поиска по небольшой таблице его создание не даст выигрыша, а на очень больших таблицах само построение индекса тоже занимает время — решайте по профилю конкретной операции.

Проверка результата и типичные ошибки

Главное правило безопасной работы с поиском: всегда проверяйте, что вернул метод, прежде чем обращаться к полям строки. Для Найти() — сравнение с Неопределено, для НайтиСтроки() — проверка количества элементов массива.

Вторая частая проблема — несовпадение типов. Если в колонке хранится ссылка на справочник, а вы ищете по коду или наименованию строкой, поиск ничего не найдёт без всякой ошибки. Проверить тип значения в колонке можно в отладчике или через ТипЗнч().

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

Ограничения и альтернативные подходы

Методы Найти() и НайтиСтроки() не поддерживают неравенства, вхождение в список и сравнение по части значения. Всё, что выходит за рамки равенства, решается циклом или запросом.

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

Для табличных частей документов доступны те же методы: Объект.Товары.Найти(...) и Объект.Товары.НайтиСтроки(...) работают идентично, поэтому приёмы из этой статьи применимы и к табличным частям без изменений.

Частые вопросы