Как добавить строки в массив 1С: 5 способов с примерами кода

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

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

1. Базовый метод: Добавление элементов в фиксированный массив

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

Пример корректного добавления в фиксированный массив:

МассивТоваров = Новый Массив(3); // Создаем массив на 3 элемента
МассивТоваров[0] = "Монитор";
МассивТоваров[1] = "Клавиатура";
МассивТоваров[2] = "Мышь";
// МассивТоваров[3] = "Наушники"; // Эта строка вызовет ошибку!

✅ Плюсы: максимальная скорость доступа к элементам
❌ Минусы: невозможно динамически расширять
🔹 Когда использовать: когда точно известно конечное количество элементов

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

2. Динамические массивы: метод Добавление()

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

Пример использования:

ДинМассив = Новый Массив;
ДинМассив.Добавление("Принтер");  // Размер массива стал 1
ДинМассив.Добавление("Сканер");   // Размер массива стал 2
ДинМассив.Добавление("Проектор"); // Размер массива стал 3

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

ИндексНового = ДинМассив.Добавление("МФУ");
Сообщить("Добавлен элемент с индексом: " + ИндексНового);

Инициализирован ли массив оператором Новый?

Достаточно ли памяти для расширения массива?

Нужно ли сохранять порядок элементов?

Планируется ли частое удаление элементов (в этом случае лучше использовать СписокЗначений)-->

3. Работа с таблицами значений: метод Добавление() vs Добавить()

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

Метод Добавить() создает новую строку и возвращает ее для заполнения:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Наименование");
ТЗ.Колонки.Добавить("Цена");

НоваяСтрока = ТЗ.Добавить(); // Создаем новую строку
НоваяСтрока.Наименование = "Ноутбук";
НоваяСтрока.Цена = 45000;

А метод Добавление() в контексте ТЗ используется для вставки уже заполненной строки:

СтрокаДляВставки = ТЗ.Добавить();
СтрокаДляВставки.Наименование = "Планшет";
ТЗ.Добавление(СтрокаДляВставки); // Вставляем заполненную строку

Метод	Назначение	Возвращаемое значение	Особенности
`Добавить()`	Создание новой пустой строки	Ссылка на новую строку	Требует последующего заполнения полей
`Добавление()`	Вставка существующей строки	Индекс добавленной строки	Может использоваться для копирования строк
`Вставить()`	Вставка строки по индексу	Индекс вставленной строки	Позволяет контролировать позицию

Добавить()|Добавление()|Вставить()|Использую оба варианта-->

4. Оптимизированное добавление: метод Вставить()

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

Пример вставки в массив:

Цвета = Новый Массив;
Цвета.Добавление("Красный");
Цвета.Добавление("Зеленый");
Цвета.Вставить(1, "Синий"); // Вставляем между красным и зеленым
// Результат: ["Красный", "Синий", "Зеленый"]

Для таблиц значений метод работает аналогично, но принимает строку в качестве второго параметра:

НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Наименование = "Монитор";
ТЗ.Вставить(0, НоваяСтрока); // Вставляем в начало таблицы

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

💡

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

5. Продвинутые техники: объединение массивов и работа с коллекциями

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

Объединение массивов можно выполнить несколькими способами:

Массив1 = Новый Массив;
Массив1.Добавление("А");
Массив1.Добавление("Б");

Массив2 = Новый Массив;
Массив2.Добавление("В");
Массив2.Добавление("Г");

// Способ 1: через цикл
Для Каждого Элемент Из Массив2 Цикл
Массив1.Добавление(Элемент);
КонецЦикла;

// Способ 2: через метод Добавить() для коллекций (8.3.10+)
Массив1.Добавить(Массив2); // Добавляет все элементы второго массива

Преобразование в другие коллекции:

// Массив → СписокЗначений
Список = Новый СписокЗначений;
Список.ЗагрузитьЗначения(Массив1);

// ТаблицаЗначений → Массив
МассивИзТЗ = ТЗ.ВыгрузитьКолонку("Наименование");

🔄 Когда объединять массивы: при слиянии данных из разных источников
🔄 Когда преобразовывать: когда нужны специфичные методы другой коллекции (например, поиск в СпискеЗначений)
⚡ Производительность: метод Добавить() для массивов работает быстрее цикла в 8.3.10+

Как ускорить работу с очень большими массивами (10000+ элементов)

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


Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Значение КАК Элемент ПОМЕСТИТЬ ВТДанные";
Запрос.Выполнить();

Для Каждого Элемент Из БольшойМассив Цикл
Запрос = Новый Запрос;
Запрос.Текст = "ВСТАВИТЬ В ВТДанные (Элемент) ЗНАЧЕНИЯ (&Элемент)";
Запрос.УстановитьПараметр("Элемент", Элемент);
Запрос.Выполнить();
КонецЦикла;

После обработки данные можно выбрать обратно в массив или таблицу значений.

6. Типичные ошибки и как их избежать

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

Ошибка индексации: попытка обратиться к несуществующему индексу
Решение: всегда проверяйте границы массива через Массив.ВГраница() или используйте конструкцию Если Массив.Количество() > Индекс Тогда
Потеря ссылок: при копировании массивов через присваивание (=) копируются только ссылки
Решение: используйте метод Массив.Скопировать() для создания глубокой копии
Утечки памяти: создание большого количества временных массивов без очистки
Решение: явно очищайте ненужные массивы оператором Массив.Очистить()

Критическая ошибка: в платформе 8.2 при добавлении элементов в массив через метод Добавление() не происходит автоматическое увеличение памяти под массив, если он был изначально создан с фиксированным размером через конструктор Новый Массив(Размер). В 8.3 это исправлено, но в старых конфигурациях может приводить к падениям.

⚠️ Внимание: При работе с массивами в управляемых формах помните, что коллекции, переданные в клиентский контекст, не поддерживают все серверные методы. Например, метод Добавление() будет работать, а Сортировать() — нет. Для сортировки на клиенте используйте Массив.Сортировать() с передачей функции сравнения.

7. Практические примеры: добавление строк в реальных задачах

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

Пример 1. Формирование списка товаров для документа

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

КонецПроцедуры

Пример 2. Динамическое формирование отчета с группировкой

Процедура ПодготовитьДанныеОтчета(РезультатыЗапроса)
ГруппыДанных = Новый Массив;
ТекущаяГруппа = "";

Для Каждого Строка Из РезультатыЗапроса Цикл
Если Строка.Группа <> ТекущаяГруппа Тогда
ГруппыДанных.Добавление(Строка.Группа);
ТекущаяГруппа = Строка.Группа;
КонецЕсли;
КонецЦикла;

Возврат ГруппыДанных;
КонецПроцедуры

Пример 3. Объединение данных из нескольких источников

Функция ОбъединитьСписки(Массив1, Массив2, Уникальность = Ложь) Результат = Новый Массив; // Добавляем элементы из первого массива Для Каждого Элемент Из Массив1 Цикл Если НЕ Уникальность ИЛИ НЕ Результат.Найти(Элемент) Тогда Результат.Добавление(Элемент); КонецЕсли; КонецЦикла; // Добавляем элементы из второго массива Для Каждого Элемент Из Массив2 Цикл Если НЕ Уникальность ИЛИ НЕ Результат.Найти(Элемент) Тогда Результат.Добавление(Элемент); КонецЕсли; КонецЦикла; Возврат Результат;

КонецФункции

💡

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

Часто задаваемые вопросы

Можно ли добавить элемент в начало массива без переиндексации?

Нет, при вставке элемента в начало массива методом Вставить(0, Значение) всегда происходит переиндексация всех существующих элементов. Это связано с внутренней реализацией массивов в 1С. Если вам часто требуется добавлять элементы в начало, рассмотрите следующие альтернативы:

Использовать Стек (реализовать через СписокЗначений с методами ДобавитьВНачало())
Добавлять элементы в конец, а затем разворачивать массив методом ОбратныйПорядок()
Для больших данных использовать временные таблицы с автоинкрементным полем

Как добавить строку в таблицу значений с проверкой на уникальность?

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

Процедура ДобавитьУникальнуюСтроку(ТЗ, Артикул, Наименование)
// Ищем существующую строку с таким артикулом
НайденныеСтроки = ТЗ.НайтиСтроки(Новый Структура("Артикул", Артикул));

Если НайденныеСтроки.Количество() = 0 Тогда
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Артикул = Артикул;
НоваяСтрока.Наименование = Наименование;
Иначе
Предупреждение("Товар с артикулом " + Артикул + " уже существует!");
КонецЕсли;
КонецПроцедуры

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

В чем разница между Добавление() и Добавить() для таблиц значений?

Это два принципиально разных метода:

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

Пример, где важен выбор правильного метода:

// Правильно: сначала Добавить(), затем заполнение
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Наименование = "Товар 1";

// Ошибка: попытка заполнить результат Добавление()
Неправильно = ТЗ.Добавление(СтрокаИзДругойТЗ);
Неправильно.Наименование = "Товар 2"; // Это не сработает!

Как оптимизировать добавление 100 000 строк в таблицу значений?

При работе с такими объемами данных следует:

Отключить автоматическое отображение прогресса: ТЗ.ОтображатьПрогресс = Ложь;
Использовать пакетное добавление через ТЗ.ЗагрузитьКолонку() если данные однотипные
Разбивать операцию на порции по 1000-5000 строк с промежуточным сохранением через ТЗ.Сжать()
Для критичных операций рассмотреть использование временных таблиц БД вместо ТЗ

Пример оптимизированного кода:

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

Для Сч = 1 По 100000 Цикл
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Поле1 = Сч;
НоваяСтрока.Поле2 = "Значение " + Сч;

// Каждые 5000 строк сжимаем таблицу
Если Сч % 5000 = 0 Тогда
ТЗ.Сжать();
КонецЕсли;
КонецЦикла;

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

Да, в массивы 1С можно добавлять как ссылки на сохраненные объекты (элементы справочников, документы), так и несохраненные объекты в памяти. Однако есть важные нюансы:

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

Пример работы с несохраненным объектом:

НовыйДокумент = Документы.ЗаказПокупателя.СоздатьДокумент();
НовыйДокумент.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Розница");

МассивДокументов = Новый Массив;
МассивДокументов.Добавление(НовыйДокумент); // Добавляем несохраненный документ

// После сохранения ссылка в массиве останется валидной
НовыйДокумент.Записать();

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