К статье
Практический материал

Другое · 9 мин

Как найти строку в массиве в 1С

Поиск строки в массиве 1С: точный поиск методом Найти, поиск подстроки через цикл, проверка результата, ошибки и альтернативы для разработчиков.

Поиск строки в массиве в 1С встречается при обработке справочников, документов, загрузке данных и разборе импортированных файлов. Массив может содержать названия контрагентов, номера договоров, статьи расходов или значения, полученные после разбиения строки разделителем. От выбора способа зависит, найдётся ли только полное совпадение или также часть значения.

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

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

Как выбрать способ поиска в массиве 1С

Способ определяется тем, что именно считается результатом: позиция элемента в массиве, сам найденный элемент или факт наличия вхождения. Если нужно знать, есть ли в массиве точное значение «Контрагент ООО», достаточно метода поиска массива. Если искомое значение может быть частью элемента, например «ООО» внутри «Контрагент ООО «Ромашка»», встроенного метода массива может быть недостаточно.

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

Поиск точного совпадения элемента массива

Для точного поиска в массиве строк в 1С используется встроенный метод поиска массива. Он возвращает позицию элемента или признак отсутствия, в зависимости от версии платформы, поэтому результат следует проверять явно. Если метод возвращает неопределённое значение, совпадений нет.

МассивСтрок = Новый Массив;
МассивСтрок.Добавить("Контрагент");
МассивСтрок.Добавить("Договор");
МассивСтрок.Добавить("Счет");

Индекс = МассивСтрок.Найти("Договор");

Если Индекс = Неопределено Тогда
// элемент не найден
Иначе
// элемент найден, Индекс — его позиция
КонецЕсли;

Этот способ подходит, когда искомое значение должно совпадать с элементом полностью. Он обычно работает быстрее цикла, так как поиск реализован внутри платформы. Однако он не находит частичные совпадения и не ищет подстроку внутри элемента.

Поиск подстроки внутри элементов массива

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

ИскомаяПодстрока = "ООО";
НайденныеЭлементы = Новый Массив;

Для Каждого Элемент Из МассивСтрок Цикл
Если Найти(Элемент, ИскомаяПодстрока) > 0 Тогда
НайденныеЭлементы.Добавить(Элемент);
КонецЕсли;
КонецЦикла;

Регистрозависимость и обработка пробелов зависят от используемой функции и настроек платформы. Если поиск должен быть независимым от регистра, приведите и элемент, и искомую строку к одному регистру перед сравнением. Лишние пробелы в начале или конце элемента могут привести к тому, что видимое совпадение не будет найдено.

Точный элементМассив.Найти(Значение)

Подходит для полного совпадения целого элемента массива

Часть строкиЦикл + функция поиска подстроки

Нужен, когда искомый текст может быть фрагментом элемента

Отсутствие результатаНеопределено или нулевой счётчик

Проверяйте перед использованием найденного индекса или элемента

Проверка результата и обработка отсутствия совпадения

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

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

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

Ограничения, производительность и частые ошибки

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

Частая ошибка — использовать поиск подстроки там, достаточно точного совпадения. Тогда находятся лишние элементы, например при поиске «Иванов» попадётся «Иванов-Младший» или «Ивановская улица». Другая ошибка — игнорировать регистр и пробелы, из-за чего одинаковые по смыслу значения не находятся.

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

Альтернативы и когда использовать другие способы

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

Для повторяющегося поиска по одному и тому же массиву можно создать временную структуру или соответствие, где ключом будет искомое значение, а значением — элемент или позиция. Тогда поиск превращается в обращение по ключу, а не в перебор. Это оправдано, если массив не меняется между поисками.

Порядок действий
  1. 1
    Определите, нужен точный элемент или подстрока
  2. 2
    При необходимости очистите строки от пробелов и приведите к одному регистру
  3. 3
    Выполните поиск методом массива или циклом с функцией подстроки
  4. 4
    Проверьте результат на отсутствие совпадений
  5. 5
    Обработайте найденные элементы и зафиксируйте индексы

При импорте из файлов полезно сначала очистить строки от лишних символов и привести к единому формату, а затем искать. Это снижает количество ложных отрицательных результатов и упрощает отладку.

Типичные ошибки при поиске строки в массиве

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

Типичные ошибки
01
Поиск подстроки методом точного совпадения массива — часть текста не будет найдена
02
Игнорирование случая отсутствия совпадения — возможны ошибки при использовании пустого результата
03
Неучёт регистра и лишних пробелов — одинаковые значения могут не находиться

Ещё одна ошибка — не обрабатывать ситуацию, когда элемент не найден. Код может попытаться использовать пустой индекс или несуществующий элемент, что приведёт к ошибке выполнения или некорректным данным. Всегда добавляйте ветку для случая отсутствия совпадения.

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

Итог

Что важно запомнить

Выбирайте способ поиска по задаче: точный элемент — метод массива, часть строки — цикл с проверкой подстроки, всегда проверяйте отсутствие результата.

Найдёт ли метод поиска массива часть строки внутри элемента?

Обычно нет: встроенный поиск массива ищет полное совпадение целого элемента. Чтобы найти элемент, содержащий искомый текст как часть строки, нужно перебирать массив циклом и проверять каждый элемент отдельно.

Что делать, если совпадений несколько?

Решите заранее, нужно ли взять первое найденное значение, все совпадения или только уникальные элементы. При наличии дублей или похожих названий лучше собрать все подходящие элементы и проверить их перед использованием.

Как учесть разный регистр и пробелы?

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

Когда лучше не использовать массив для поиска?

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

Нужно ли проверять результат поиска?

Да. Всегда проверяйте, найдено ли совпадение, перед использованием индекса или элемента. Отсутствие проверки может привести к ошибкам выполнения или обработке не тех данных.