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

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

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

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

Теоретические основы и объявление структуры

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

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

⚠️ Внимание: В 1С индексация массивов начинается с нуля, а не с единицы. Попытка обратиться к элементу с индексом 1 в пустом массиве или массиве с одним элементом приведет к ошибке "Индекс за границей диапазона".

Размерность структуры определяется динамически. Вы можете создать массив из 10 строк, где первая строка будет иметь 5 столбцов, а вторая — 100 столбцов. Такая "рваная" структура (jagged array) вполне допустима и иногда необходима для специфических алгоритмов сжатия данных или работы с разреженными матрицами.

Алгоритм создания и инициализация ячеек

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

Рассмотрим классический пример создания матрицы 3x3. Мы создаем внешний массив размером 3. Далее запускаем цикл от 0 до 2. На каждой итерации цикла мы присваиваем текущему элементу внешнего массива новый объект Массив также размером 3. Теперь у нас есть полноценная сетка, к которой можно обращаться через двойную индексацию Массив[Строка][Колонка].

ДвумерныйМассив = Новый Массив(3);
Для Сч = 0 По 2 Цикл
ДвумерныйМассив[Сч] = Новый Массив(3);
КонецЦикла;
ДвумерныйМассив[0][0] = 100;
ДвумерныйМассив[1][2] = "Текст";

Такой подход гарантирует, что память под структуру выделена корректно. Если вы попытаетесь записать значение в ДвумерныйМассив[0][0] без предварительной инициализации внутреннего массива на позиции 0, платформа выдаст исключение. Это частая ошибка новичков, которые привыкли к автоматическому расширению массивов в других средах.

Заполнение данными и работа с циклами

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

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

При работе с большими объемами данных следует помнить о производительности. Операция обращения к элементу массива в 1С достаточно быстрая, но вложенные циклы с глубокими вычислениями могут замедлить работу системы. Использование вложенных циклов требует осторожности при обработке массивов размером более нескольких тысяч элементов.

Сравнение с Таблицей Значений

Часто перед разработчиком встает выбор: использовать двумерный массив или объект ТаблицаЗначений. Оба инструмента позволяют хранить табличные данные в памяти, но имеют различную природу и сферу применения. Массивы более гибки в плане типов данных внутри одной строки, тогда как Таблица Значений требует строгой схемы колонок.

Главное преимущество массива — скорость создания и минимальные накладные расходы на инициализацию. Вам не нужно описывать колонки, их типы и длину. Однако отсутствие схемы усложняет работу с данными: вы должны точно помнить, что лежит в колонке с индексом 2. В Таблице Значений вы обращаетесь к данным по именам колонок, что делает код более читаемым и поддерживаемым.

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

Характеристика	Двумерный Массив	Таблица Значений
Описание структуры	Не требуется (динамическая)	Обязательно (Колонки, Типы)
Обращение к данным	По числовому индексу [0][1]	По имени колонки ["Имя"]
Гибкость типов в строке	Полная (любой тип в любой ячейке)	Ограничена типом колонки
Встроенные методы	Минимальные (только базовые)	Мощные (Поиск, Сортировка, Фильтр)

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

Типичные ошибки и отладка кода

Наиболее распространенной проблемой при работе с многомерными массивами является ошибка "Индекс за границей диапазона". Она возникает в двух случаях: либо вы пытаетесь обратиться к несуществующему элементу (например, 11-му элементу в массиве из 10), либо пытаетесь использовать второй индекс для элемента, который еще не является массивом.

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

⚠️ Внимание: При копировании массивов помните, что присваивание переменной копирует только ссылку на объект. Изменение данных в копии затронет и оригинал. Для создания независимой копии используйте метод Массив.Скопировать().

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

Секрет быстрой отладки

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

Оптимизация и лучшие практики

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

Используйте типизацию там, где это возможно. Несмотря на то, что 1С позволяет хранить любые типы, явное приведение типов или проверка типа перед операцией (ТипЗнч()) помогает избежать скрытых ошибок и делает код более предсказуемым для других разработчиков, которые будут поддерживать вашу конфигурацию.

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

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

Да, платформа 1С не ограничивает глубину вложенности. Вы можете создать массив, элементами которого являются двумерные массивы. Синтаксис обращения будет выглядеть как Массив[X][Y][Z]. Однако поддержка такого кода становится значительно сложнее.

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

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

В чем разница между Массив и Таблица в 1С?

Массив — это коллекция элементов, доступ к которым осуществляется по числовому индексу. Таблица (ТаблицаЗначений) — это объект с именованными колонками, поддерживающий специфические методы работы с данными, такие как поиск по условию и сортировка.

Почему возникает ошибка при присваивании значения?

Скорее всего, вы пытаетесь записать значение во внутренний массив, который еще не создан. Убедитесь, что перед строкой Массив[i][j] = Значение выполнена инициализация Массив[i] = Новый Массив().