Как проверить, входит ли значение в массив 1С: полное руководство с примерами

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

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

Материал будет полезен как начинающим разработчикам 1С, так и опытным программистам, которые хотят оптимизировать свой код. Все примеры приведены для актуальных версий платформы 8.3.x и протестированы на реальных конфигурациях.

1. Стандартный метод Найти(): простой и надёжный способ

Самый очевидный и часто используемый метод — Массив.Найти(Значение). Он возвращает индекс элемента, если значение найдено, или -1, если его нет. Этот способ идеален для небольших массивов и простых проверок.

Пример использования:

МассивТоваров = Новый Массив;
МассивТоваров.Добавить("Молоко");
МассивТоваров.Добавить("Хлеб");
МассивТоваров.Добавить("Яйца");

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

Преимущества метода:

• 🔹 Простота и читаемость кода — идеально для быстрых проверок
• 🔹 Работает со всеми типами данных (строки, числа, ссылки на объекты)
• 🔹 Не требует дополнительных библиотек или модулей

Ограничения:

• ⚠️ Низкая производительность на больших массивах (более 1000 элементов)
• ⚠️ Не различает NULL и неопределённые значения без дополнительных проверок

2. Использование цикла Для Каждого: гибкость и контроль

Когда требуется не только проверить наличие элемента, но и выполнить дополнительные действия (например, модифицировать данные или собрать статистику), удобнее использовать явный перебор элементов через Для Каждого.

Пример с дополнительной логикой:

МассивЗаказов = Новый Массив;
МассивЗаказов.Добавить(СсылкаНаЗаказ1);
МассивЗаказов.Добавить(СсылкаНаЗаказ2);

Найден = Ложь;
Для Каждого Заказ Из МассивЗаказов Цикл
Если Заказ.Дата >= НачалоДня(ТекущаяДата()) Тогда
Найден = Истина;
Прервать; // Досрочный выход, если достаточно одного совпадения
КонецЕсли;
КонецЦикла;

Когда использовать:

• 🔹 Нужно обработать каждый элемент массива
• 🔹 Требуется сложная логика проверки (например, по нескольким полям)
• 🔹 Массив содержит объекты с методами, которые нужно вызвать

Важно: При работе с большими массивами (10 000+ элементов) цикл Для Каждого может быть в 2-3 раза медленнее, чем специализированные методы вроде Найти() или коллекций.

3. Проверка через ВРег/НРег: игнорируем регистр

Если массив содержит строки и требуется поиск без учёта регистра, стандартный Найти() не подойдёт — он чувствителен к регистру. В этом случае поможет комбинация функций ВРег() (верхний регистр) или НРег() (нижний регистр).

Пример:

МассивПоставщиков = Новый Массив;
МассивПоставщиков.Добавить("ООО Ромашка");
МассивПоставщиков.Добавить("ИП Иванов");

ПоисковоеЗначение = "ооо ромашка";
Найден = Ложь;
Для Каждого Поставщик Из МассивПоставщиков Цикл
Если ВРег(Поставщик) = ВРег(ПоисковоеЗначение) Тогда
Найден = Истина;
Прервать;
КонецЕсли;
КонецЦикла;

Нюансы:

• 🔹 ВРег() работает быстрее, чем НРег(), так как не требует преобразования в Unicode для некоторых кодировок
• 🔹 Для больших массивов лучше заранее создать массив в верхнем регистре и искать по нему

4. Коллекции Структура и Соответствие: оптимизация для частых проверок

Когда проверка вхождения выполняется многократно (например, в цикле обработки большого объёма данных), стандартные массивы становятся неэффективными. В этом случае лучше использовать коллекции Структура или Соответствие, которые обеспечивают доступ к элементам за константное время O(1).

Пример с Соответствие:

// Создаём коллекцию один раз
Клиенты = Новый Соответствие;
Клиенты.Вставить("Иванов", Истина);
Клиенты.Вставить("Петров", Истина);

// Быстрая проверка
Если Клиенты.СодержитКлюч("Иванов") Тогда
Сообщить("Клиент Иванов найден");
КонецЕсли;

Сравнение коллекций:

⚠️ Внимание: Коллекции не подходят для динамически изменяемых данных — если массив часто модифицируется, лучше использовать комбинированный подход: коллекцию для проверок и массив для хранения.

5. Работа с массивами ссылок на объекты 1С

Особую сложность представляет проверка вхождения, когда массив содержит ссылки на объекты (справочники, документы). Здесь стандартный Найти() может давать ложные результаты из-за особенностей сравнения ссылок в 1С.

Правильный способ:

МассивДокументов = Новый Массив;
МассивДокументов.Добавить(Документы.ЗаказПокупателя.НайтиПоНомеру("0001"));

ИскомаяСсылка = Документы.ЗаказПокупателя.НайтиПоНомеру("0001");
Найден = Ложь;
Для Каждого Док Из МассивДокументов Цикл
Если Док.Ссылка = ИскомаяСсылка.Ссылка Тогда
Найден = Истина;
Прервать;
КонецЕсли;
КонецЦикла;

Типичные ошибки:

• ❌ Сравнение по УникальныйИдентификатор() — работает медленнее, чем сравнение ссылок
• ❌ Использование Найти() без проверки типа — может найти "похожие" объекты
• ❌ Проверка по номеру документа без учёта даты — приводит к коллизиям

Сравнивайте именно свойство .Ссылка|Используйте ТипЗнч() для фильтрации типов|Для больших массивов заранее индексируйте ссылки в Соответствие|Помните, что ПустаяСсылка не равна NULL-->

6. Оптимизация для больших массивов: бинарный поиск и хэши

Если массив содержит более 10 000 элементов и требуется максимальная производительность, стоит рассмотреть:

1. Бинарный поиск — требует предварительной сортировки массива, но даёт скорость O(log n).
2. Хэш-таблицы — реализация через Соответствие с хэшированием ключей.

Пример бинарного поиска (требует сортированный массив):

// Массив должен быть отсортирован!
МассивЧисел = Новый Массив;
МассивЧисел.Добавить(10);
МассивЧисел.Добавить(20);
МассивЧисел.Добавить(30);
МассивЧисел.Сортировать();

Функция БинарныйПоиск(Массив, ИскомоеЗначение)
ЛеваяГраница = 0;
ПраваяГраница = Массив.ВГраница();
Mientras ЛеваяГраница <= ПраваяГраница Цикл
Середина = Цел(ЛеваяГраница + (ПраваяГраница - ЛеваяГраница) / 2);
Если Массив[Середина] = ИскомоеЗначение Тогда
Возврат Середина;
ИначеЕсли Массив[Середина] < ИскомоеЗначение Тогда
ЛеваяГраница = Середина + 1;
Иначе
ПраваяГраница = Середина - 1;
КонецЕсли;
КонецЦикла;
Возврат -1;
КонецФункции;

⚠️ Внимание: Бинарный поиск не работает с объектами 1С (справочниками, документами), так как их сравнение не поддерживает операторы < и >. Для объектов используйте только хэш-таблицы.

7. Альтернативные подходы: LINQ и расширения массивов

В современных версиях 1С:Предприятие 8.3.20+ появились новые возможности для работы с массивами, напоминающие LINQ из .NET:

• 🔹 Метод Массив.Где() — фильтрация элементов по условию
• 🔹 Метод Массив.Содержит() — прямой аналог проверки вхождения
• 🔹 Метод Массив.Первый() — поиск первого совпадения

Пример с Содержит():

Если МассивТоваров.Содержит("Яблоки") Тогда
Сообщить("Яблоки есть в наличии");
КонецЕсли;

Эти методы удобны, но имеют ограничения:

• ⚠️ Работают медленнее, чем Найти() для простых проверок
• ⚠️ Не поддерживаются в старых версиях платформы (до 8.3.20)

FAQ: Частые вопросы по проверке значений в массивах 1С

Для Каждого Элемент Из Массив Цикл
Если НЕ ЗначениеЗаполнено(Элемент) Тогда
Сообщить("Найден пустой элемент");
КонецЕсли;
КонецЦикла;

СоответствиеПоБуквам = Новый Соответствие;
Для Каждого Товар Из БольшойМассивТоваров Цикл
ПерваяБуква = Лев(Товар, 1);
Если НЕ СоответствиеПоБуквам.СодержитКлюч(ПерваяБуква) Тогда
СоответствиеПоБуквам.Вставить(ПерваяБуква, Новый Массив);
КонецЕсли;
СоответствиеПоБуквам[ПерваяБуква].Добавить(Товар);
КонецЦикла;

ВЫБРАТЬ РазрешённыеТовары.Ссылка
ПОМЕСТИТЬ втРазрешённые
ИЗ Справочник.Товары КАК РазрешённыеТовары
ГДЕ РазрешённыеТовары.ПометкаУдаления = Ложь;

Если втРазрешённые.Найти(ИскомыйТовар) <> Неопределён Тогда
// Товар разрешён
КонецЕсли;

Функция НайтиВМногомерномМассиве(Массив, ИскомоеЗначение)
Для Каждого Подмассив Из Массив Цикл
Если Подмассив.Найти(ИскомоеЗначение) <> -1 Тогда
Возврат Истина;
КонецЕсли;
КонецЦикла;
Возврат Ложь;
КонецФункции;