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

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

Эта статья не просто даст определение термину, а раскроет все нюансы работы с массивами в 1С 8.3 и 1С 8.2. Мы разберем синтаксис, рассмотрим реальные примеры кода, сравним производительность разных подходов и даже покажем, как массивы взаимодействуют с другими коллекциями (например, Структура или Соответствие). Если вы когда-нибудь сталкивались с ошибками при работе с массивами или просто хотите оптимизировать свой код — здесь вы найдете ответы.

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

1. Что такое массив в 1С: базовое определение и назначение

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

Основные характеристики массивов в 1С:

• 📌 Индексация с нуля: первый элемент имеет индекс 0, второй — 1, и так далее. Это важно помнить, чтобы избежать ошибок при обращении к элементам.
• 🔄 Динамическое изменение размера: можно добавлять или удалять элементы"на лету" с помощью методов Добавить, Удалить или Очистить.
• 🔍 Типизация элементов: массив может содержать данные любого типа (числа, строки, объекты 1С, другие массивы), но лучше придерживаться однотипности для предсказуемости кода.
• 🔗 Ссылка на объект: при присвоении массива другой переменной создается не копия, а ссылка на тот же объект. Это влияет на модификацию данных.

Где применяются массивы? Практически везде:

• 📊 Обработка данных из табличных частей документов (например, расчет сумм по строкам).
• 🔄 Передача параметров между функциями или модулями.
• 📂 Хранение временных данных при обмене с внешними системами (JSON, XML).
• 🔍 Поиск и фильтрация элементов по сложным условиям.

Пример простейшего массива:

МассивЧисел = Новый Массив(3); // Создаем массив с 3 элементами
МассивЧисел[0] = 10;
МассивЧисел[1] = 20;
МассивЧисел[2] = 30;

2. Виды массивов в 1С: одномерные, многомерные и особенности

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

2.1. Одномерные массивы

Это классический"список" элементов, где каждый имеет свой индекс. Используется в 90% задач:

ИменаПользователей = Новый Массив;
ИменаПользователей.Добавить("Иванов");
ИменаПользователей.Добавить("Петров");
ИменаПользователей.Добавить("Сидоров");

Особенности:

• 📌 Легкость создания и модификации.
• 🔍 Быстрый доступ к элементам по индексу (О(1) по скорости).
• 🔄 Поддержка методов Найти, ВГраница, Количество.

2.2. Многомерные массивы

Это массивы, элементы которых сами являются массивами. Например, двумерный массив можно представить как таблицу с строками и столбцами:

ТаблицаДанных = Новый Массив;
// Создаем первую"строку"
Строка1 = Новый Массив;
Строка1.Добавить("Яблоки");
Строка1.Добавить(100);
// Создаем вторую"строку"
Строка2 = Новый Массив;
Строка2.Добавить("Груши");
Строка2.Добавить(200);

// Добавляем строки в основной массив
ТаблицаДанных.Добавить(Строка1);
ТаблицаДанных.Добавить(Строка2);

Когда использовать многомерные массивы?

• 📊 Для представления табличных данных (например, экспорт в Excel).
• 🔄 При работе с иерархическими структурами (дерево категорий).
• 📂 Для временного хранения данных из запросов с группировкой.

3. Создание и инициализация массивов: синтаксис и примеры

В 1С:Предприятие есть несколько способов создать массив. Выбор метода зависит от задачи и стиля программирования. Рассмотрим основные подходы с примерами.

3.1. Создание пустого массива

Самый простой способ — инициализация без элементов:

ПустойМассив = Новый Массив;

Такой массив имеет Количество = 0 и готов к добавлению элементов.

3.2. Создание массива с фиксированным размером

Если заранее известен размер массива, можно указать его при создании:

МассивНа10Элементов = Новый Массив(10); // Создает массив с 10 элементами (индексы 0-9)

⚠️ Внимание: При создании массива с фиксированным размером все элементы инициализируются значением Неопределено. Это может привести к ошибкам, если не проверять значения перед использованием.

3.3. Инициализация массива данными

Можно сразу заполнить массив значениями:

МассивСтрок = Новый Массив Из {"Красный","Зеленый","Синий"};

Или добавлять элементы по одному:

МассивЧисел = Новый Массив;
МассивЧисел.Добавить(1);
МассивЧисел.Добавить(2);
МассивЧисел.Добавить(3);

3.4. Создание массива из другого массива (клонирование)

Чтобы клонировать массив, используйте метод Скопировать:

Оригинал = Новый Массив Из {1, 2, 3};
Копия = Оригинал.Скопировать; // Теперь это независимый массив

4. Основные методы работы с массивами в 1С

Массивы в 1С поддерживают богатый набор методов для манипуляции данными. Разберем самые полезные из них с примерами.

4.1. Добавление и удаление элементов

• 🔹 Добавить(Значение) — добавляет элемент в конец массива.
• 🔹 Вставить(Индекс, Значение) — вставляет элемент по указанному индексу.
• 🔹 Удалить(Индекс) — удаляет элемент по индексу.
• 🔹 Очистить — удаляет все элементы.

Пример:

Массив = Новый Массив Из {"А","Б","В"};
Массив.Добавить("Г"); // {"А","Б","В","Г"}
Массив.Вставить(1,"АА"); // {"А","АА","Б","В","Г"}
Массив.Удалить(2); // {"А","АА","В","Г"}

4.2. Поиск и сортировка

• 🔹 Найти(Значение) — возвращает индекс первого вхождения или -1.
• 🔹 Индекс(Значение) — синоним метода Найти.
• 🔹 Сортировать(Направление) — сортирует элементы (НаправлениеСортировки.Возр или НаправлениеСортировки.Убыв).

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

Числа = Новый Массив Из {5, 2, 8, 1};
Числа.Сортировать(НаправлениеСортировки.Возр); // {1, 2, 5, 8}

4.3. Агрегатные функции

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

• 🔹 Мин / Макс — минимальное и максимальное значение.
• 🔹 Сумма — сумма всех числовых элементов.
• 🔹 Среднее — среднее арифметическое.

Пример:

Цены = Новый Массив Из {100, 200, 150};
Сообщить("Сумма:" + Цены.Сумма); // Выведет 450

Индекс = Массив.Найти("ИскомоеЗначение");
Если Индекс <> -1 Тогда
// Элемент найден
Иначе
// Элемент не найден
КонецЕсли;

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

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

5.1. Обработка табличной части документа

Допустим, нужно рассчитать сумму строк в документе"РеализацияТоваровУслуг" с учетом скидки:

// Получаем табличную часть
ТабличнаяЧасть = Документ.Товары;

// Создаем массив для хранения сумм со скидкой
СуммыСоСкидкой = Новый Массив;

// Проходим по строкам
Для Каждого Строка Из ТабличнаяЧасть Цикл
СуммаСоСкидкой = Строка.Сумма * (1 - Строка.Скидка/100);
СуммыСоСкидкой.Добавить(СуммаСоСкидкой);
КонецЦикла;

5.2. Построение отчета с группировкой данных

Массивы удобны для временного хранения данных при формировании отчетов. Например, группировка продаж по менеджерам:

ГруппыПродаж = Новый Массив;
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Продажи.Менеджер КАК Менеджер,
| СУММА(Продажи.Сумма) КАК Сумма
|ИЗ
| Документ.Продажи КАК Продажи
|ГРУППИРОВКА ПО
| Продажи.Менеджер";

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

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

5.3. Обмен данными с внешними системами (JSON)

При интеграции с API часто приходится конвертировать данные в массивы и обратно. Пример работы с JSON:

// Получаем JSON-строку из внешней системы
JSONСтрока ='{"товары": ["Товар1","Товар2","Товар3"]}';

// Разбираем в массив
МассивТоваров = JSON.Прочитать(JSONСтрока).товары;

// Обрабатываем данные
Для Каждого Товар Из МассивТоваров Цикл
Сообщить(Товар);
КонецЦикла;

6. Оптимизация работы с массивами: скорость и память

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

6.1. Быстродействие операций

Скорость выполнения операций с массивами зависит от их типа:

• 🔹 Добавление в конец (Добавить) — O(1) (быстро).
• 🔹 Вставка/удаление в середину — O(n) (медленно для больших массивов).
• 🔹 Доступ по индексу — O(1) (мгновенно).
• 🔹 Поиск элемента (Найти) — O(n) (линейный поиск).

Для массивов размером более 10 000 элементов рассмотрите использование коллекции"СписокЗначений" — она оптимизирована для больших данных и поддерживает быстрый поиск.

6.2. Память и сборка мусора

Массивы в 1С управляются сборщиком мусора, но есть нюансы:

• 🔹 Большие массивы (Количество > 100 000) могут вызывать задержки при очистке памяти.
• 🔹 Если массив больше не нужен, вызовите Очистить или присвойте переменной Неопределено.
• 🔹 Избегайте создания массивов в циклах — лучше заранее выделить память.

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

// Плохо: создаем массив в каждом витке цикла
Для i = 1 По 1000 Цикл
ВременныйМассив = Новый Массив;
//.. операции..
КонецЦикла;

// Хорошо: создаем один раз
ВременныйМассив = Новый Массив;
Для i = 1 По 1000 Цикл
ВременныйМассив.Очистить;
//.. операции..
КонецЦикла;

6.3. Альтернативы массивам

В некоторых случаях лучше использовать другие коллекции:

⚠️ Внимание: В версиях 1С ниже 8.3.10 нет встроенной коллекции"Множество". Для проверки уникальности элементов используйте массив + метод Найти или Соответствие.

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

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

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

Самая частая ошибка возникает при попытке обратиться к несуществующему индексу:

Массив = Новый Массив Из {10, 20};
Сообщить(Массив[2]); // ОШИБКА! Индексы 0 и 1

Как избежать:

• 🔹 Всегда проверяйте Количество перед доступом.
• 🔹 Используйте Попытка..Исключение для обработки ошибок.

7.2. Неявное изменение массива по ссылке

При присвоении массива другой переменной создается ссылка, а не копия:

Массив1 = Новый Массив Из {1, 2, 3};
Массив2 = Массив1; // Это ссылка!
Массив2[0] = 100;
// Теперь Массив1[0] тоже равен 100!

Решение: используйте Скопировать для создания независимой копии.

7.3. Забывают инициализировать элементы

При создании массива фиксированного размера все элементы инициализируются как Неопределено:

Массив = Новый Массив(5); // Все элементы = Неопределено
Сумма = Массив[0] + 10; // ОШИБКА! Неопределено + число

Всегда инициализируйте элементы перед использованием:

Для i = 0 По Массив.ВГраница Цикл
Массив[i] = 0; // Инициализация нулями
КонецЦикла;

7.4. Некорректная сортировка

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

// Ошибка: попытка отсортировать массив объектов без компаратора
СписокТоваров.Сортировать; // Не сработает!

// Правильно: передаем функцию сравнения
СписокТоваров.Сортировать(СравнитьТоварыПоНаименованию);

Функция СравнитьТоварыПоНаименованию(Товар1, Товар2)
Возврат СтрСравнить(Товар1.Наименование, Товар2.Наименование);
КонецФункции

8. Массивы vs другие коллекции 1С: что выбрать?

В 1С:Предприятие помимо массивов есть и другие коллекции: СписокЗначений, Структура, Соответствие, ТаблицаЗначений. Когда стоит использовать массивы, а когда — альтернативы?

8.1. Сравнение массива и СпискаЗначений

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

8.2. Когда выбрать Структуру или Соответствие?

Если вам нужен ассоциативный доступ по ключу (а не по индексу), лучше использовать:

• 🔹 Структура — для хранения набора именованных свойств одного объекта.
• 🔹 Соответствие — для создания словаря"ключ-значение" (например, кэш данных).

Пример с Соответствием:

КэшЦен = Новый Соответствие;
КэшЦен.Вставить("Товар1", 100);
КэшЦен.Вставить("Товар2", 200);

// Быстрый доступ по ключу
Цена = КэшЦен.Получить("Товар1");

8.3. ТаблицаЗначений для сложных данных

Если вам нужна полноценная таблица с колонками, фильтрацией и сортировкой, используйте ТаблицаЗначений:

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

// Добавляем строку
Строка = Таблица.Добавить;
Строка.Наименование ="Товар1";
Строка.Цена = 100;

- Нужна скорость и простота? → Массив

- Нужно отображение в форме? → СписокЗначений

- Нужен доступ по ключу? → Соответствие

- Нужна таблица с колонками? → ТаблицаЗначений-->

FAQ: Частые вопросы о массивах в 1С

Массив = Новый Массив Из {1, 2, 3};
Размер = Массив.Количество; // Вернет 3

ПоследнийИндекс = Массив.ВГраница; // Вернет 2

СмешанныйМассив = Новый Массив;
СмешанныйМассив.Добавить(100); // Число
СмешанныйМассив.Добавить("Строка"); // Строка
СмешанныйМассив.Добавить(Истина); // Булево

МассивОбъектов.Сортировать(СравнитьПоДате);

Функция СравнитьПоДате(Объект1, Объект2)
Если Объект1.Дата > Объект2.Дата Тогда
Возврат 1;
И