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

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

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

Объявление массива и базовое заполнение в цикле

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

МассивЧисел = Новый Массив;

Для Сч = 1 По 10 Цикл
МассивЧисел.Добавить(Сч * 100);
КонецЦикла;

После выполнения этого кода массив содержит десять элементов: 100, 200, ..., 1000. Проверить результат можно через МассивЧисел.Количество() — метод вернёт 10. Обратите внимание: индексация элементов в 1С начинается с нуля, поэтому первый элемент доступен как МассивЧисел[0], а последний — как МассивЧисел[МассивЧисел.Количество() - 1].

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

Массив = Новый Массив;
Для Сч = 1 По 5 Цикл
    Массив.Добавить("Элемент " + Сч);
КонецЦикла;
Сообщить(Массив.Количество()); // 5

Заполнение массива при обходе результата запроса

Самая частая практическая задача — собрать в массив значения из выборки запроса, например список ссылок на документы или контрагентов для последующей пакетной обработки. Здесь используется цикл Пока Выборка.Следующий() Цикл.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   РеализацияТоваровУслуг.Ссылка КАК Ссылка
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
|ГДЕ
|   РеализацияТоваровУслуг.Дата МЕЖДУ &НачалоПериода И &КонецПериода";

Запрос.УстановитьПараметр("НачалоПериода", НачалоМесяца(ТекущаяДатаСеанса()));
Запрос.УстановитьПараметр("КонецПериода", КонецМесяца(ТекущаяДатаСеанса()));

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

Пока Выборка.Следующий() Цикл
МассивДокументов.Добавить(Выборка.Ссылка);
КонецЦикла;

Если нужны только уникальные значения, проще не фильтровать массив вручную, а добавить в текст запроса ключевое слово РАЗЛИЧНЫЕ — это снимает дубликаты на стороне СУБД, что быстрее и надёжнее. Альтернатива — проверка Если Массив.Найти(Значение) = Неопределено Тогда перед добавлением, но на больших объёмах такой поиск внутри цикла заметно замедляет выполнение.

Заполнение массива из табличной части и таблицы значений

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

МассивНоменклатуры = Новый Массив;

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

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

Для таблицы значений существует альтернатива без явного цикла: метод ВыгрузитьКолонку("ИмяКолонки") возвращает готовый массив значений колонки. Это короче и быстрее, но не позволяет применять условия отбора — для фильтрации придётся сначала использовать НайтиСтроки() или Скопировать() с отбором.

Заполнение массива фиксированного размера и методы Вставить и Установить

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

КоличествоСтрок = ТаблицаДанных.Количество();
МассивСумм = Новый Массив(КоличествоСтрок);

Для Индекс = 0 По КоличествоСтрок - 1 Цикл
МассивСумм[Индекс] = ТаблицаДанных[Индекс].Сумма * 1.2;
КонецЦикла;

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

Метод УстановитьГраницу(НовыйРазмер) изменяет размер уже существующего массива: при увеличении новые элементы получают значение Неопределено, при уменьшении лишние элементы отбрасываются. Это удобно, когда размер вычисляется после частичного заполнения.

Двумерные массивы и вложенные циклы

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

Матрица = Новый Массив;

Для Строка = 1 По 5 Цикл
СтрокаМатрицы = Новый Массив;
Для Колонка = 1 По 5 Цикл
СтрокаМатрицы.Добавить(Строка * Колонка);
КонецЦикла;
Матрица.Добавить(СтрокаМатрицы);
КонецЦикла;

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

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

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

После заполнения массива полезно убедиться, что он содержит ожидаемые данные. Минимальный набор проверок: количество элементов через Количество(), наличие конкретного значения через Найти() и просмотр содержимого в отладчике или через ВыгрузитьЗначения() в табло.

Если МассивДокументов.Количество() = 0 Тогда
ВызватьИсключение "Не найдено документов для обработки";
КонецЕсли;

Для Каждого Элемент Из МассивДокументов Цикл
Сообщить(Элемент);
КонецЦикла;

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

Производительность и ограничения

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

Ещё одно ограничение: массив не имеет встроенных методов сортировки и уникализации. Для сортировки используют либо сортировку на уровне запроса (УПОРЯДОЧИТЬ ПО), либо перенос данных в таблицу значений с методом Сортировать(), либо объект СписокЗначений, у которого есть СортироватьПоЗначению(). Выбор структуры данных под задачу часто важнее оптимизации самого цикла.

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