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

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

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

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

Базовый синтаксис и конструктор объектов

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

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

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

Рассмотрим классический пример объявления. Вы можете создать переменную и сразу инициализировать её новым экземпляром. Такой код легко читается и поддерживается коллегами.

// Создание пустого массива
МойМассив = Новый Массив;

Альтернативный, но менее предпочтительный способ — использование функции НовыйМассив(). Хотя он работает аналогично конструктору, современные стандарты разработки 1С рекомендуют использовать именно синтаксис Новый Тип для единообразия кода. Это упрощает рефакторинг и поиск по коду.

ℹ️ Интерфейс и поведение объектов могут незначительно отличаться в зависимости от версии платформы 1С:Предприятие. Рекомендуется сверять актуальную справку по встроенному языку для вашей конкретной версии конфигурации.

Инициализация с предварительным размером и заполнением

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

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

// Создание массива размером 10 элементов
Размер = 10;
МассивДанных = Новый Массив(Размер);

// Заполнение нулями
Для Счетчик = 0 По Размер - 1 Цикл
МассивДанных[Счетчик] = 0;
КонецЦикла;

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

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

Почему индексация с нуля?

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

Работа с Фиксированным массивом

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

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

Характеристика	Обычный Массив	Фиксированный Массив
Добавление элементов	Разрешено	Запрещено
Удаление элементов	Разрешено	Запрещено
Изменение по индексу	Разрешено	Разрешено
Очистка коллекции	Разрешено	Запрещено

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

// Шаг 1: Создание и наполнение обычного массива
ВременныйМассив = Новый Массив;
ВременныйМассив.Добавить("Элемент 1");
ВременныйМассив.Добавить("Элемент 2");

// Шаг 2: Создание фиксированной версии
ЗащищенныйМассив = Новый ФиксированныйМассив(ВременныйМассив);

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

Платформа 1С не поддерживает понятие "многомерный массив" в явном виде, как это реализовано в языках типа C++ или Pascal с синтаксисом Array[5, 5]. Вместо этого используется концепция вложенности, когда элементом массива выступает другой массив. Это позволяет создавать структуры любой сложности и размерности.

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

• 📦 Внешний массив выступает в роли контейнера для строк данных.
• 📦 Внутренние массивы представляют собой отдельные строки с ячейками.
• 📦 Доступ к элементу осуществляется двойной индексацией: Массив[Строка][Колонка].

Рассмотрим пример создания матрицы 3 на 3. Здесь мы видим вложенный цикл, который отвечает за инициализацию каждой строки. Такой код легко масштабировать под любые размеры, просто изменив параметры циклов.

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

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

Методы манипуляции данными в массиве

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

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

⚠️ Внимание: Метод Удалить принимает индекс удаляемого элемента. После удаления все последующие элементы сдвигаются влево, и их индексы уменьшаются на единицу. Если вы удаляете элементы в цикле, идя с начала массива, вы можете пропустить некоторые элементы или получить ошибку выхода за границы.

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

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

Особенности типизации и производительность

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

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

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

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

Можно ли изменить размер фиксированного массива?

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

Что будет, если обратиться к несуществующему индексу?

Если вы попытаетесь прочитать элемент по индексу, который больше или равен свойству Количество, система выдаст ошибку выполнения "Индекс находится за границами диапазона". При записи в такой индекс массив автоматически расширится.

Как очистить массив полностью?

Для полного удаления всех элементов используется метод Очистить(). После его вызова свойство Количество станет равным 0, но сама переменная останется объектом типа Массив, готовым к новому наполнению.

В чем разница между Массивом и СпискомЗначений?

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

Поддерживает ли 1С ассоциативные массивы?

В явном виде ассоциативных массивов (словарей) в классическом понимании нет, но их роль выполняет структура Структура или Соответствие, где доступ к элементам осуществляется по ключу-строке, а не по числовому индексу.