Что такое массив данных в 1С и как с ним работать

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

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

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

Что представляет собой массив во встроенном языке 1С

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

Массив не накладывает ограничений на типы хранимых значений. Технически допустимо поместить в один массив строку, число и ссылку на документ, однако на практике так делать не стоит: смешанные типы усложняют обработку и провоцируют ошибки приведения типов. Рабочее правило — один массив хранит данные одного смыслового типа, например список ссылок на реализации или набор артикулов.

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

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

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

// Пустой массив
СписокДокументов = Новый Массив();

// Добавление элементов
СписокДокументов.Добавить(ДокументСсылка);
СписокДокументов.Вставить(0, ПервыйДокумент); // в начало списка

// Массив заданного размера
Данные = Новый Массив(10); // 10 неопределённых элементов

Метод Добавить() помещает элемент в конец массива, а Вставить(Индекс, Значение) — в указанную позицию со сдвигом остальных элементов. Для замены значения используется прямое присваивание по индексу: Массив[2] = НовоеЗначение.

Типовой сценарий наполнения — обход выборки из запроса с добавлением каждой ссылки в массив. Такой массив затем передаётся в процедуру печати, обработки или обмена данными. Это стандартный приём, встречающийся почти в каждой конфигурации.

Основные методы массива

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

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

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

Как обойти массив в цикле

Существует два основных способа перебора элементов. Первый — цикл Для Каждого ... Из ... Цикл, который последовательно отдаёт каждое значение без работы с индексами. Это предпочтительный вариант, когда нужно просто обработать все элементы.

// Вариант 1: обход значений
Для Каждого Документ Из СписокДокументов Цикл
    ОбработатьДокумент(Документ);
КонецЦикла;

// Вариант 2: обход по индексам
Для Индекс = 0 По СписокДокументов.ВГраница() Цикл
    Сообщить("Элемент " + Индекс + ": " + СписокДокументов[Индекс]);
КонецЦикла;

Второй способ — классический цикл по индексам от 0 до ВГраница(). Он нужен, когда внутри цикла требуется сам индекс (например, для нумерации строк в сообщении) или когда элементы нужно изменять по месту через присваивание Массив[Индекс] = ....

Перед обходом полезно проверять, что массив вообще содержит элементы: Если Массив.Количество() = 0 Тогда .... Это защищает от лишней работы и делает поведение кода предсказуемым, когда выборка оказалась пустой.

Массив и другие коллекции: что выбрать

Во встроенном языке 1С несколько типов коллекций, и выбор между ними влияет на читаемость и скорость кода. Массив — не универсальное решение.

Практическое правило: если данные — простой перечень однотипных значений, берите массив; если нужен быстрый поиск по ключу — соответствие; если несколько связанных полей на запись — таблицу значений. Передача таблицы значений туда, где достаточно массива ссылок, — распространённый признак избыточного кода.

Типичные ошибки при работе с массивами

Большинство ошибок с массивами связано с индексацией и изменением коллекции во время обхода. Они проявляются либо как явное исключение «Индекс находится за границами массива», либо как тихая порча логики обработки.

Отдельная группа проблем — работа с массивом, полученным извне, например из параметра процедуры. Если параметр может быть не заполнен, перед обращением к методам массива проверяйте тип: Если ТипЗнч(Параметр) = Тип("Массив") Тогда .... Иначе при передаче Неопределено код упадёт на первом же вызове Количество().

Как проверить корректность работы с массивом

После написания кода с массивом результат проверяется фактическим выполнением на контрольных данных. Минимальный набор проверок: пустой массив, массив из одного элемента и массив с типичным объёмом данных.

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

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

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