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

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

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

Основы структуры данных и объявление

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

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

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

Ниже приведен пример кода, демонстрирующий создание заготовки для двумерной структуры:

МассивДанных = Новый Массив;
// Внешний цикл создаст"строки"
Для Счетчик = 0 По 9 Цикл
НоваяСтрока = Новый Массив;
// Внутренний массив пока пуст, он будет заполнен далее
МассивДанных.Добавить(НоваяСтрока);
КонецЦикла;

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

Заполнение вложенными циклами

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

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

Вот как выглядит классический алгоритм заполнения числовыми значениями:

Для ИндексСтроки = 0 По МассивДанных.ВГраница Цикл
// Получаем ссылку на текущую строку-массив
ТекущаяСтрока = МассивДанных[ИндексСтроки];

Для ИндексКолонки = 0 По 4 Цикл
// Вычисляем значение, например, произведение индексов
Значение = ИндексСтроки * ИндексКолонки;
ТекущаяСтрока.Добавить(Значение);
КонецЦикла;
КонецЦикла;

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

Прямая запись по индексам

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

Для реализации этого подхода сначала необходимо инициализировать массивы нужного размера. Метод УстановитьРазмер позволяет зарезервировать память под определенное количество элементов. После этого вы можете обращаться к любому элементу как Массив[Строка][Колонка]. Это напоминает работу с обычными двумерными массивами в языках типа C++ или Java.

Пример прямой записи данных:

Массив = Новый Массив(5); // 5 строк
Для Сч1 = 0 По 4 Цикл
Массив[Сч1] = Новый Массив(3); // 3 колонки в каждой строке
Для Сч2 = 0 По 2 Цикл
// Прямая запись значения
Массив[Сч1][Сч2] ="Данные" + Сч1 +":" + Сч2;
КонецЦикла;
КонецЦикла;

⚠️ Внимание: При прямой записи убедитесь, что внутренний массив уже создан и присвоен элементу внешнего массива. Попытка выполнить Массив[0][0] = 1 для пустого внешнего массива вызовет ошибку индексации.

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

Инициализация конкретными значениями

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

Для заполнения сложными типами удобно использовать конструкторы объектов непосредственно в теле цикла. Например, если вы формируете список контрагентов с их реквизитами, вы можете создавать новые объекты СтрокаТаблицыЗначений или простые Структура и помещать их в ячейки. Это создает мощные вложенные структуры данных.

Рассмотрим пример заполнения массива датами и строковыми комментариями:

Тип данных	Пример значения	Способ создания
Дата	01.01.2026 12:00	Новый Дата(2026, 01, 01)
Строка	"Тестовое значение"	Литерал или конкатенация
Число	123.45	Арифметическое выражение
Булево	Истина	Логическая операция

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

Особенности хранения объектов в массиве

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

Оптимизация производительности при больших объемах

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

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

Для ускорения работы с большими данными можно применять следующие приемы:

• 🚀 Предварительно устанавливайте размер массива через конструктор Новый Массив(Количество).
• 🚀 Избегайте создания временных объектов внутри цикла, если это возможно.
• 🚀 Используйте локальные переменные для хранения ссылок на часто используемые объекты.

⚠️ Внимание: В старых версиях платформы 1С (до 8.3.10) операции с большими массивами могли выполняться существенно медленнее. Если вы поддерживаете старые конфигурации, проведите нагрузочное тестирование.

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

Преобразование и вывод результатов

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

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

Пример преобразования массива в таблицу значений:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Поле1", ТипОписанияТипов("Число"));
ТЗ.Колонки.Добавить("Поле2", ТипОписанияТипов("Строка"));

Для Каждого СтрокаМассива Из МассивДанных Цикл
НоваяСтрокаТЗ = ТЗ.Добавить;
НоваяСтрокаТЗ.Поле1 = СтрокаМассива[0];
НоваяСтрокаТЗ.Поле2 = СтрокаМассива[1];
КонецЦикла;

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

Как узнать размерность массива в 1С?

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

Можно ли создать трехмерный массив?

Да, платформа не ограничивает вложенность. Вы можете создать массив, содержащий массивы, которые содержат массивы. Однако поддержка такого кода становится сложной, и часто лучше использовать объекты типа Структура или ТаблицаЗначений с дополнительными измерениями.

Что быстрее: Массив или ТаблицаЗначений?

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

Как очистить двумерный массив?

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