Массив в 1С: что это и как с ним работать

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

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

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

Что такое массив и где он применяется

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

Типичные сценарии использования: накопление ссылок на документы перед групповой обработкой, сбор значений для параметра запроса с оператором «В», передача списка отобранных товаров из формы подбора, временное хранение строк перед записью в табличную часть. Многие методы платформы сами возвращают массивы — например, метод НайтиПоНаименованию справочника или выгрузка колонки таблицы значений.

Как создать и заполнить массив

Массив создаётся конструктором «Новый Массив». Без параметров получается пустой массив; если передать число, создаётся массив указанной размерности с незаполненными элементами (значение Неопределено). Для многомерного массива размерности перечисляются через запятую.

Заполнение выполняется методом Добавить(Значение) — элемент попадает в конец коллекции. Метод Вставить(Индекс, Значение) помещает значение в произвольную позицию, сдвигая остальные элементы. Установить конкретное значение можно и прямым присваиванием по индексу, если позиция уже существует.

Товары = Новый Массив;
Товары.Добавить("Номенклатура1");
Товары.Добавить("Номенклатура2");
// Обращение по индексу
Первый = Товары[0];
// Проверка размера
Размер = Товары.Количество();

Полезные методы для управления составом: Удалить(Индекс) убирает элемент, Очистить() опустошает массив целиком, Найти(Значение) возвращает индекс первого совпадения или Неопределено, ВГраница() даёт индекс последнего элемента. Перед удалением в цикле помните, что индексы оставшихся элементов смещаются.

Как перебрать элементы массива

Существует два основных способа обхода. Первый — цикл «Для Каждого … Из … Цикл», который последовательно отдаёт каждое значение без ручной работы с индексами. Он короче и безопаснее: нельзя случайно выйти за границы массива. Второй — классический цикл «Для … По … Цикл» с обращением по индексу; он нужен, когда важна позиция элемента или требуется обход с конца.

// Вариант 1: без индексов
Для Каждого Товар Из Товары Цикл
    Сообщить(Товар);
КонецЦикла;

// Вариант 2: по индексам, с конца
Для Инд = 0 По Товары.ВГраница() Цикл
    ОбратныйИнд = Товары.ВГраница() - Инд;
    Сообщить(Товары[ОбратныйИнд]);
КонецЦикла;

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

Многомерные массивы и вложенные структуры

Конструктор «Новый Массив(3, 5)» создаёт двумерный массив — три строки по пять элементов. Обращение идёт через двойные скобки: Массив[0][2]. На практике многомерные массивы применяются редко: для табличных данных удобнее таблица значений, где у колонок есть имена и типы.

Более живучий приём — массив структур: каждый элемент массива является структурой с именованными полями (например, «Ссылка», «Количество», «Цена»). Такой подход сочетает порядковый доступ массива и читаемость именованных полей, и часто используется для передачи строк данных между серверными функциями.

Чем массив отличается от других коллекций 1С

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

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

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

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

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

Массив напрямую передаётся как параметр запроса с оператором «В»: Запрос.УстановитьПараметр("Ссылки", МассивСсылок). Это стандартный способ фильтрации по списку значений, и он работает быстрее, чем динамическая сборка текста запроса. Пустой массив в таком параметре корректно вернёт пустой результат, но логику отчёта стоит предусмотреть заранее.

В управляемых формах массив свободно передаётся между клиентскими и серверными процедурами, если содержит сериализуемые значения (примитивы, ссылки, структуры из них). Объекты типа «ТаблицаЗначений» или «ДеревоЗначений» так передать нельзя — для них существуют реквизиты формы. Учитывайте также, что каждый серверный вызов с большим массивом — это пересылка данных; при массовых обработках лучше выполнять всю логику в одной серверной процедуре.

Частые вопросы о массивах в 1С