Добавление элементов в массив в 1С Предприятие

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

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

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

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

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

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

МойМассив = Новый Массив;
// Или с указанием начальной емкости
МойМассив = Новый Массив(10);

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

Метод Добавь: расширение коллекции в конец

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

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

Пример добавления простых значений:

СписокТоваров = Новый Массив;
СписокТоваров.Добавь("Ноутбук");
СписокТоваров.Добавь("Мышь");
СписокТоваров.Добавь("Клавиатура");

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

Метод Вставить: размещение элемента по индексу

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

Индексация в 1С начинается с нуля. Это означает, что первый элемент имеет индекс 0, а последний — Массив.ВГраница. Если вы укажете индекс, превышающий текущую границу массива более чем на 1, система выдаст ошибку. Однако вставить элемент сразу после последнего (индекс = Граница + 1) допускается, и это действие будет эквивалентно методу Добавь.

Рассмотрим ситуацию, когда необходимо вставить приоритетный товар в начало списка:

МассивПриоритет = Новый Массив;
МассивПриоритет.Добавь("Товар Б");
МассивПриоритет.Добавь("Товар В");
// Вставляем"Товар А" в начало (индекс 0)
МассивПриоритет.Вставить(0,"Товар А");

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

Работа с индексами и границами массива

Корректное определение границ коллекции необходимо для избежания ошибок выхода за пределы диапазона. В 1С существуют специальные методы для получения нижней и верхней границы. Для массивов нижняя граница всегда равна 0, но использование метода НГраница делает код более универсальным и читаемым.

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

Сравнение методов получения размера:

Метод / Свойство	Возвращаемое значение для пустого массива	Возвращаемое значение для массива из 3 элементов	Описание
ВГраница	-1	2	Индекс последнего элемента
Количество	0	3	Фактическое число элементов
НГраница	0	0	Индекс первого элемента

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

Типы данных и хранение объектов в массиве

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

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

Пример работы со структурами:

СписокСотрудников = Новый Массив;
НовыйСотрудник = Новый Структура("ФИО, Должность","Иванов И.И.","Менеджер");
СписокСотрудников.Добавь(НовыйСотрудник);
// Изменение объекта повлияет на элемент в массиве
НовыйСотрудник.Должность ="Старший менеджер";

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

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

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

При работе с большими объемами данных (десятки и сотни тысяч строк) способ добавления элементов может существенно влиять на время выполнения кода. Как упоминалось ранее, частое использование метода Вставить в начало массива приводит к квадратичной сложности алгоритма O(n²).

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

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

Почему Вставить медленнее Добавь?

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

Частые ошибки и способы их устранения

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

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

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

Можно ли добавить в массив другой массив?

Да, массив в 1С может содержать в качестве элементов другие массивы. Это позволяет создавать многомерные структуры или матрицы. При обращении к такому элементу вы получите объект массива, к методам которого можно обращаться дальше, например: Массив[0].Добавь(1).

Что произойдет, если добавить элемент с индексом больше ВГраница + 1?

Система выдаст исключение"Индекс выходит за пределы диапазона". Метод Вставить позволяет создать разрыв в индексах только одним способом: вставив элемент сразу за последним. Заполнить"дыру" в середине массива нельзя, массив всегда должен быть сплошным.

Как очистить массив перед добавлением новых данных?

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

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

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