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

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

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

1. Базовые способы создания массивов в 1С

В 1С:Предприятие 8.3 существует несколько способов инициализации массивов. Начнем с самого простого — использования конструктора Новый Массив(). Этот метод универсален и подходит для большинства задач:

```1c

Перем мойМассив;

мойМассив = Новый Массив(); // Пустой массив

```

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

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

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

```1c

Перем дниНедели;

дниНедели = Новый Массив(7); // Массив из 7 элементов типа "Неопределено"

```

2. Создание массивов с использованием метода Добавить()

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

Пример пошагового добавления элементов:

```1c

Перем динамическийМассив;

динамическийМассив = Новый Массив();

динамическийМассив.Добавить("Первый элемент");

динамическийМассив.Добавить(42);

динамическийМассив.Добавить(ТекущаяДата());

```

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

```1c

динамическийМассив.Вставить(1, "Вставленный элемент"); // Вставка на вторую позицию (индекс 1)

```

• ➕ Добавление в конец: массив.Добавить(элемент) — самый быстрый способ.
• 🔀 Вставка по индексу: массив.Вставить(индекс, элемент) — сдвигает остальные элементы.
• 🧹 Очистка массива: массив.Очистить() — удаляет все элементы, но сохраняет объект.

3. Массивы фиксированного размера и их особенности

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

```1c

Перем буферДанных;

буферДанных = Новый Массив(100); // Массив на 100 элементов

```

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

Для заполнения массива фиксированного размера часто используется цикл Для:

```1c

Для инд = 0 По буферДанных.ВГраница() Цикл

буферДанных[инд] = инд * 10; // Заполняем значениями 0, 10, 20..

КонецЦикла;

```

⚠️ Внимание: При работе с массивами фиксированного размера не путайте методы ВГраница() и Количество(). Первый возвращает максимальный индекс (на 1 меньше количества элементов), а второй — общее количество элементов. Например, для массива из 5 элементов ВГраница() вернет 4.

4. Работа с многомерными массивами

1С:Предприятие не поддерживает настоящие многомерные массивы (как, например, в Python или C#), но их можно эмулировать с помощью массивов массивов. Это полезно для работы с табличными данными, матрицами или иерархическими структурами.

Пример создания двумерного массива (матрицы) 3×3:

```1c

Перем матрица;

матрица = Новый Массив();

Для строка = 0 По 2 Цикл

матрица.Добавить(Новый Массив(3)); // Добавляем строку из 3 элементов

Для столбец = 0 По 2 Цикл

матрица[строка][столбец] = строка * 3 + столбец + 1;

КонецЦикла;

КонецЦикла;

```

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

```1c

Сообщить(матрица[1][2]); // Выведет 6

```

• 📊 Двумерные массивы: Массив массивов (например, для таблиц данных).
• 🌳 Иерархические структуры: Массивы с вложенными массивами разной глубины.
• 🔄 Динамическое изменение размерности: Можно добавлять/удалять строки и столбцы.

5. Создание массивов из коллекций и запросов

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

Например, чтобы получить массив всех элементов справочника Номенклатура, можно использовать следующий код:

```1c

Перем массивНоменклатуры;

массивНоменклатуры = Справочники.Номенклатура.Выбрать();

Пока массивНоменклатуры.Следующий() Цикл

// Обработка каждого элемента

КонецЦикла;

```

Однако более эффективный способ — использовать метод Выгрузить(), который сразу преобразует выборку в массив:

```1c

Перем массивДанных;

массивДанных = Справочники.Номенклатура.Выбрать().Выгрузить();

```

При работе с запросами результат также можно преобразовать в массив. Например:

```1c

Запрос = Новый Запрос;

Запрос.Текст = "ВЫБРАТЬ Первые 10 Наименование ИЗ Справочник.Номенклатура";

РезультатЗапроса = Запрос.Выполнить();

массивРезультатов = РезультатЗапроса.Выгрузить();

```

⚠️ Внимание: Метод Выгрузить() создает массив только из выбранных полей. Если в выборке участвуют несколько колонок, каждый элемент массива будет представлять собой Структура с ключами-именами колонок. Например: массивРезультатов[0].Наименование.

Выбрать источник данных (справочник, документ, запрос)

Использовать метод Выгрузить() для выборок

Проверить структуру полученных данных (массив строк или массив структур)

Обработать исключения (например, пустые выборки)-->

6. Типичные ошибки и их решение

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

Ошибка 1: выход за границы массива

При попытке обратиться к несуществующему индексу (например, массив[10] в массиве из 5 элементов) 1С выдаст исключение. Чтобы избежать этого, всегда проверяйте границы с помощью ВГраница():

```1c

Если индекс <= мойМассив.ВГраница() Тогда

// Безопасный доступ

Иначе

Сообщить("Индекс вне границ массива!");

КонецЕсли;

```

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

Если в массиве смешаны разные типы данных (например, числа и строки), 1С может автоматически приводить их к одному типу, что приводит к неожиданным результатам. Например:

```1c

массив = Новый Массив(10, "20");

результат = массив[0] + массив[1]; // Будет "1020" (строка), а не 30 (число)!

```

Ошибка 3: поверхностное копирование

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

7. Оптимизация работы с массивами

При работе с большими массивами (тысячи элементов) важно учитывать производительность. Несколько советов для оптимизации:

• ⚡ Предварительное выделение памяти: Если известно примерное количество элементов, создавайте массив заранее с помощью Новый Массив(размер). Это сокращает количество перераспределений памяти.
• 🔍 Используйте Найти() вместо ручного перебора: Для поиска элемента в массиве метод Найти() работает быстрее, чем цикл Для.
• 🗑️ Удаляйте ненужные элементы: Если массив используется как буфер, очищайте его методом Очистить() вместо создания нового.
• 🔄 Избегайте частых вставок в начало массива: Каждая вставка в начало требует сдвига всех элементов, что замедляет работу.

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

```1c

// Плохо: динамическое добавление в цикле

массив = Новый Массив();

Для i = 1 По 10000 Цикл

массив.Добавить(i); // Многократное перераспределение памяти

КонецЦикла;

// Хорошо: предварительное выделение памяти

массив = Новый Массив(10000);

Для i = 0 По 9999 Цикл

массив[i] = i + 1; // Без перераспределений

КонецЦикла;

```

8. Продвинутые техники: массивы структур и соответствий

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

Пример массива структур для хранения информации о товарах:

```1c

Перем товары;

товары = Новый Массив();

новаяСтруктура = Новый Структура("Наименование, Цена, Количество");

новаяСтруктура.Наименование = "Ноутбук";

новаяСтруктура.Цена = 50000;

новаяСтруктура.Количество = 10;

товары.Добавить(новаяСтруктура);

новаяСтруктура = Новый Структура("Наименование, Цена, Количество");

новаяСтруктура.Наименование = "Смартфон";

новаяСтруктура.Цена = 30000;

новаяСтруктура.Количество = 20;

товары.Добавить(новаяСтруктура);

```

Доступ к данным в таком массиве осуществляется через индекс и ключ:

```1c

Сообщить(товары[0].Наименование); // Выведет "Ноутбук"

```

Массивы соответствий удобны для хранения пар "ключ-значение" с возможностью быстрого поиска:

```1c

Перем словарьТоваров;

словарьТоваров = Новый Массив();

словарьТоваров.Добавить(Новый Соответствие("Код, Наименование"));

// Добавляем элементы

словарьТоваров[0].Вставить("001", "Ноутбук");

словарьТоваров[0].Вставить("002", "Смартфон");

// Поиск по ключу

Если словарьТоваров[0].Получить("001") <> Неопределено Тогда

Сообщить("Найден товар: " + словарьТоваров[0].Получить("001"));

КонецЕсли;

```

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

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

массивЭлементов = Новый Массив();
Для Каждого элемент Из ЭлементыФормы Цикл
массивЭлементов.Добавить(элемент);
КонецЦикла;
 

Если ТипЗнч(элемент) = Тип("ПолеВвода") Тогда
массивЭлементов.Добавить(элемент);
КонецЕсли;
 

Перем динамическийМассив, реальныйРазмер, виртуальныйРазмер;
реальныйРазмер = 10;
виртуальныйРазмер = 0;
динамическийМассив = Новый Массив(реальныйРазмер);

Процедура ДобавитьЭлемент(значение)
Если виртуальныйРазмер >= реальныйРазмер Тогда
реальныйРазмер = реальныйРазмер * 2;
НовыйМассив = Новый Массив(реальныйРазмер);
Для i = 0 По виртуальныйРазмер - 1 Цикл
НовыйМассив[i] = динамическийМассив[i];
КонецЦикла;
динамическийМассив = НовыйМассив;
КонецЕсли;
динамическийМассив[виртуальныйРазмер] = значение;
виртуальныйРазмер = виртуальныйРазмер + 1;
КонецПроцедуры
 

массивЧисел = Новый Массив(5, 1, 8, 3);
массивЧисел.Сортировать(НаправлениеСортировки.Возр); // По возрастанию
 

массивСтруктур.СортироватьПоКлючу("Цена", НаправлениеСортировки.Убыв);
 

список = Новый СписокЗначений();
список.Добавить("Элемент 1");
список.Добавить("Элемент 2");
 

Процедура ОбработатьМассив(массив)
Для i = 0 По массив.ВГраница() Цикл
массив[i] = массив[i] * 2; // Удвоим все элементы
КонецЦикла;
КонецПроцедуры

// Использование
данные = Новый Массив(1, 2, 3);
ОбработатьМассив(данные);
// Теперь данные = [2, 4, 6]
 

ОбработатьМассив(Новый Массив(оригинальныйМассив));