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

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

В этой статье разберём 5 основных способов добавления значений в массив 1С — от базового метода Добавить() до работы с динамическими коллекциями и структурами. Особое внимание уделим нюансам, которые не описаны в стандартной документации: как избежать дублирования элементов, почему иногда Вставить() работает медленнее Добавить(), и что делать, если массив suddenly становится "неизменяемым". Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.22).

1. Базовый метод: Добавление()

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

МассивТоваров = Новый Массив;
МассивТоваров.Добавить("Молоко");
МассивТоваров.Добавить("Хлеб");
МассивТоваров.Добавить(100); // Можно смешивать типы данных

Важные особенности метода:

🔹 Автоматическое расширение: массив динамически увеличивает размер при добавлении нового элемента.
🔹 Типизация: в один массив можно добавлять значения разных типов (строка, число, дата и т.д.), но это может усложнить последующую обработку.
🔹 Производительность: на больших объёмах данных (10 000+ элементов) рекомендуется заранее задавать размер массива через Новый Массив(10000).

Ошибка, которую часто допускают новички — попытка добавить элемент в массив, объявленный как Неопределён:

Перем МассивДанных; // Переменная не инициализирована!

МассивДанных.Добавить("Тест"); // Вызовет ошибку: "МассивДанных не является значением объекта"

💡

Если нужно добавить несколько элементов сразу, используйте конструктор массива: Массив = Новый Массив(1, 2, 3, "А", "Б"). Это быстрее, чем последовательные вызовы Добавить()

2. Вставка элементов по индексу: Вставить()

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

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

Ключевые нюансы метода:

🔸 Смещение элементов: все элементы после указанного индекса автоматически сдвигаются вправо.
🔸 Исключение при выходе за границы: если указать индекс больше текущего размера массива (например, Вставить(10, "Чёрный") в массив из 3 элементов), платформа выбросит ошибку.
🔸 Производительность: операция Вставить() медленнее Добавить(), так как требует перераспределения памяти для сдвига элементов.

Что произойдёт при вставке в отрицательный индекс?

При указании отрицательного индекса (например, Вставить(-1, "Фиолетовый")) платформа 1С преобразует его в позицию с конца массива. То есть -1 — это последний элемент, -2 — предпоследний и т.д. Однако такой трюк работает только для чтения элементов, но не для вставки! При попытке вставить по отрицательному индексу вы получите ошибку "Индекс вне границ массива".

Практический пример: добавление заголовка в начало массива строк:

ОтчётныеДанные = Новый Массив("Январь", "Февраль", "Март");
ОтчётныеДанные.Вставить(0, "Квартал 1");
// Результат: ["Квартал 1", "Январь", "Февраль", "Март"]

3. Объединение массивов: Добавить() с параметром

Если нужно добавить в массив не один элемент, а целую коллекцию, у метода Добавить() есть перегруженная версия с двумя параметрами: Добавить(Значение, Позиция). Когда в качестве Значение передаётся другой массив, происходит его объединение с текущим:

ОсновнойМассив = Новый Массив(1, 2, 3);
ДополнительныйМассив = Новый Массив(4, 5);
ОсновнойМассив.Добавить(ДополнительныйМассив);
// Результат: [1, 2, 3, [4, 5]] – ВНИМАНИЕ! Так работает НЕПРАВИЛЬНО!

Это типичная ошибка! Чтобы объединить массивы (а не вложить один в другой), используйте цикл или метод Вставить() для каждого элемента:

ОсновнойМассив = Новый Массив(1, 2, 3);
ДополнительныйМассив = Новый Массив(4, 5);
Для Каждого Элемент Из ДополнительныйМассив Цикл
ОсновнойМассив.Добавить(Элемент);
КонецЦикла;
// Правильный результат: [1, 2, 3, 4, 5]

Метод	Синтаксис	Производительность	Подходит для
`Добавить(Элемент)`	`Массив.Добавить(10)`	⭐⭐⭐⭐⭐	Добавление одиночных элементов в конец
`Вставить(Индекс, Элемент)`	`Массив.Вставить(0, "Новый")`	⭐⭐⭐	Вставка в произвольную позицию
Цикл `Для Каждого`	`Для Каждого Эл Из Массив2 Цикл Массив1.Добавить(Эл)`	⭐⭐⭐⭐	Объединение массивов
`СоединитьМассивы()` (самостоятельная функция)	`Результат = СоединитьМассивы(Массив1, Массив2)`	⭐⭐⭐⭐⭐	Частое объединение больших массивов

4. Работа с динамическими массивами (СписокЗначений и Соответствие)

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

СписокЗначений удобен, когда нужно хранить пары "значение + представление" (например, для выпадающих списков в формах):

СписокТоваров = Новый СписокЗначений;
СписокТоваров.Добавить(Новый Структура("Значение, Представление", 101, "Молоко 3.2%"));
СписокТоваров.Добавить(Новый Структура("Значение, Представление", 102, "Хлеб Бородинский"));

Соответствие (аналог словаря) позволяет добавлять элементы по ключу:

ЦеныТоваров = Новый Соответствие;
ЦеныТоваров.Вставить("Молоко", 65.50);
ЦеныТоваров.Вставить("Хлеб", 42.00);
// Доступ к элементу: Цена = ЦеныТоваров["Молоко"];

Важные отличия от обычного массива:

📌 Уникальность ключей: в Соответствии нельзя добавить два элемента с одинаковым ключом (последний перезапишет предыдущий).
📌 Произвольный доступ: элементы Соответствия не упорядочены, в отличие от Массива или СпискаЗначений.
📌 Методы добавления: вместо Добавить() используется Вставить(Ключ, Значение).

💡

Для хранения больших объёмов данных (1000+ элементов) с быстрым поиском по ключу Соответствие работает эффективнее, чем массив, так как использует хеш-таблицу.

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

В реальных задачах редко требуется просто добавить элемент в массив. Чаще нужно:

Проверить наличие дубликатов
Обработать исключения (например, попытку добавления Неопределён)
Добавлять элементы условно (например, только положительные числа)

Пример кода с проверкой на дубликаты:

Процедура ДобавитьУникальныйЭлемент(Массив, НовыйЭлемент)
Если НЕ Массив.Найти(НовыйЭлемент) Тогда
Массив.Добавить(НовыйЭлемент);
КонецЕсли;
КонецПроцедуры

Обработка ошибок при добавлении:

Попытка
Массив.Добавить(Неопределён); // Провоцируем ошибку
Исключение
Сообщить("Ошибка добавления: " + ОписаниеОшибки());
// Альтернативный код обработки
КонецПопытки;

Убедиться, что массив инициализирован (НЕ Неопределён)|Проверить тип добавляемого значения (если требуется)|Обработать возможное дублирование|Учесть ограничения на размер массива (для статических массивов)-->

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

Функция ДобавитьССортировкой(Массив, НовыйЭлемент)
Массив.Добавить(НовыйЭлемент);
Массив.Сортировать(НаправлениеСортировки.Возр);
Возврат Массив;
КонецФункции

6. Особенности работы с массивами в разных версиях 1С

Поведение массивов может отличаться в зависимости от версии платформы 1С:Предприятие. Основные различия:

1С 8.2 vs 8.3:

⚡ В 8.2 метод Найти() возвращает Неопределён, если элемент не найден. В 8.3 — -1.
⚡ В 8.3.10+ появилась поддержка ДинамическийМассив (аналог ArrayList в других языках), который оптимизирован для частых вставок/удалений.

Тонкие клиенты и веб-клиенты:

🌐 В тонком клиенте массивы передаются на сервер по ссылке, что может привести к неожиданным изменениям данных.
🌐 В веб-клиенте ограничен размер передаваемых массивов (обычно до 10 МБ).

Если Ложь Тогда // Этот код выполнится только в режиме отладки
Сообщить("Версия платформы: " + Строка(ПлатформаВерсия()));
КонецЕсли;

-->

Пример кода с учётом версии:

Если ПлатформаВерсия() >= "8.3.10" Тогда
Массив = Новый ДинамическийМассив; // Используем оптимизированный тип
Иначе
Массив = Новый Массив;
КонецЕсли;

Как узнать текущую версию платформы без кода?

Откройте главное меню 1С:Предприятие, выберите Справка → О программе. В окне будет указана точная версия платформы (например, 8.3.22.1830).

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

Даже опытные разработчики иногда сталкиваются с неожиданным поведением массивов. Разберём самые распространённые ошибки:

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

Ошибка 1: "Индекс вне границ массива"

Возникает при попытке обратиться к несуществующему индексу. Решение — всегда проверять размер массива перед доступом:

Если Индекс >= 0 И Индекс < Массив.ВГраница() Тогда
Элемент = Массив[Индекс];
Иначе
Сообщить("Некорректный индекс!");
КонецЕсли;

Ошибка 2: Потеря данных при присваивании

В 1С массивы — это объекты, и оператор = копирует только ссылку, а не данные:

Массив1 = Новый Массив(1, 2, 3);
Массив2 = Массив1; // Это НЕ копия, а ссылка!
Массив2.Добавить(4);
// Теперь Массив1 тоже содержит [1, 2, 3, 4]!

Чтобы создать реальную копию, используйте Массив2 = Массив1.Скопировать().

Ошибка 3: Неявное преобразование типов

1С автоматически преобразует типы при добавлении, что может привести к потере данных:

Массив = Новый Массив;
Массив.Добавить("123"); // Строка
Массив.Добавить(456);   // Число
// При сортировке "123" будет больше чем 456!

FAQ: Ответы на частые вопросы

Как добавить элемент в начало массива без сдвига всех элементов?

В стандартном массиве 1С это невозможно — метод Вставить(0, Элемент) всегда сдвигает остальные элементы, что снижает производительность. Альтернативные решения:

Используйте СписокЗначений с методом Вставить() — он оптимизирован для таких операций.
Создайте новый массив и скопируйте элементы в обратном порядке.
В 1С 8.3.10+ используйте ДинамическийМассив.

Можно ли добавить в массив элемент другого массива (вложенный массив)?

Да, но важно понимать разницу между вложением и объединением:

🔹 Массив1.Добавить(Массив2) — добавит Массив2 как единый элемент (вложение).
🔹 Цикл Для Каждого — объединит элементы (см. раздел 3 статьи).

Пример вложенного массива:

Матрица = Новый Массив;
Строка1 = Новый Массив(1, 2, 3);
Строка2 = Новый Массив(4, 5, 6);
Матрица.Добавить(Строка1);
Матрица.Добавить(Строка2);
// Матрица[0] — это массив [1, 2, 3]

Как добавить в массив данные из запроса 1С?

Для добавления результатов запроса в массив используйте конструкцию Выбрать() с циклом:

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

Выборка = РезультатЗапроса.Выбрать();
Пока Выборка.Следующий() Цикл
МассивДанных.Добавить(Выборка.Наименование);
КонецЦикла;

Для больших выборок (1000+ строк) лучше использовать Массив = РезультатЗапроса.Выгрузить() — это быстрее, чем построчное добавление.

Почему после добавления элементов массив становится "неизменяемым"?

Это происходит, если:

Массив был получен из неизменяемого источника (например, результат функции ЗначениеВМассив() без параметра Изменяемый).
Вы работаете в безопасном режиме (например, в веб-клиенте с ограниченными правами).
Массив был зафиксирован для передачи между контекстами (например, в фоновое задание).

Решение: всегда явно создавайте изменяемый массив:

Массив = Новый Массив(,, Истина); // Третий параметр "Изменяемый"

Как добавить в массив структуру или другой сложный тип?

Массивы 1С поддерживают хранение любых типов данных, включая структуры, соответствия и даже объекты справочников. Пример:

МассивОбъектов = Новый Массив;
СтруктураДанных = Новый Структура("Имя, Возраст, ДатаРождения", "Иван", 30, '1993-05-15');
МассивОбъектов.Добавить(СтруктураДанных);

// Доступ к полям структуры:
Имя = МассивОбъектов[0].Имя;

Важно: при добавлении ссылочных типов (например, справочников) в массив копируется только ссылка, а не сам объект. Изменение оригинального объекта повлияет на данные в массиве.

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