Другое · 8 мин
Массив в 1С: что это и как с ним работать
Что такое массив в 1С: для чего нужен, как создавать и заполнять, чем отличается от таблицы значений, какие операции безопасны и на какие ошибки обратить внимание.
Массив в 1С — это динамическая коллекция значений, упорядоченная по числовым индексам. В одном массиве могут храниться числа, строки, даты, ссылки на справочники, документы, объекты и даже другие массивы. Размер массива не фиксирован: элементы можно добавлять, вставлять, удалять и очищать в процессе выполнения кода.
Основное отличие от таблицы значений или структуры — отсутствие именованных полей и ключей. Обращение к элементу осуществляется только по позиции. Это делает массив удобным для списков, последовательностей и временных наборов, но не подходит для поиска по произвольному имени без дополнительного обхода.
Массивы часто используют при выгрузке и загрузке данных, формировании отборов, обработке строк табличной части и передаче набора значений между процедурами. При этом массив сам по себе не содержит метаданных о типах элементов, поэтому ответственность за согласованность лежит на разработчике.
Перед работой с массивом нужно понимать, где он создаётся: в модуле объекта, менеджера, формы или общем модуле. Область видимости и время жизни определяют, будут ли данные доступны после завершения процедуры или транзакции.
Как создать и заполнить массив
Создание массива начинается с инициализации пустой коллекции. После этого в неё можно добавлять элементы по одному или в цикле, если источник данных уже известен. Важно сразу определить, какие значения будут храниться: однородный набор упрощает обработку, смешанный требует дополнительных проверок типа перед использованием.
Заполнение может выполняться из справочника, документа, запроса или результата вычислений. Если данные приходят из запроса, удобно перебирать выборку и добавлять в массив только нужные поля или ссылки. При массовом заполнении стоит следить за объёмом памяти, особенно если в массиве попадают большие объекты или вложенные табличные части.
При создании массива в форме или общем модуле нужно учитывать, кто будет иметь доступ к его содержимому. Массив, созданный в локальной процедуре, недоступен за её пределами, если не передан как параметр или не сохранён в общем хранилище состояния.
- 1Создайте массив с помощью конструктора нового массива
- 2Добавьте элементы методом добавления или вставьте по индексу
- 3Обращайтесь к элементу по индексу и проверяйте границы перед чтением
- 4Удаляйте элементы осторожно, так как индексы остальных элементов смещаются
Как читать и менять элементы
Чтение элемента выполняется по его позиции в коллекции. Перед обращением стоит убедиться, что запрошенный индекс существует, иначе выполнение может прерваться с ошибкой. Изменение элемента не меняет размер массива, но заменяет значение в указанной позиции.
Если нужно обойти все элементы, используйте перебор по количеству элементов коллекции. При этом не полагайтесь на фиксированную длину, так как массив может быть изменён другими частями программы между проверкой и обращением. Для критичных участков полезно зафиксировать количество элементов перед началом цикла.
При передаче массива в другую процедуру уточняйте, будет ли вызываемый код изменять коллекцию. Изменения внутри вызываемой процедуры могут отразиться на исходном массиве, если не создана явная копия. Это особенно важно при работе с общими данными и документами.
Добавление, вставка и удаление
Добавление в конец массива — самая простая операция, не требующая перестройки существующих позиций. Вставка в середину сдвигает все элементы, стоящие после указанной позиции, что может повлиять на производительность при больших коллекциях. Удаление тоже вызывает сдвиг последующих элементов и изменение их индексов.
При удалении элементов по одному из начала или середины коллекции позиции оставшихся элементов пересчитываются. Поэтому при массовой очистке часто удобнее удалять с конца или полностью очищать массив, если весь набор больше не нужен. Полная очистка освобождает память и сбрасывает коллекцию в начальное состояние.
Если в процессе работы массив передаётся между формами или сеансами, проверяйте целостность после каждой операции изменения. Пропущенный элемент или неверный индекс может привести к обработке не той строки, не того контрагента или не той суммы.
Многомерные массивы и вложенные коллекции
Массив может содержать другие массивы, что позволяет строить таблицы, матрицы или иерархические наборы без использования таблицы значений. Такой подход подходит для временных расчётов, когда структура известна заранее и не требует именованных колонок. Обращение к вложенному элементу требует указания двух и более индексов последовательно.
Вложенные массиовы усложняют отладку: ошибка в одном индексе может привести к обращению к не той вложенной коллекции или к элементу другого типа. Перед работой с многомерной структурой полезно проверить наличие родительского массива и достаточное количество вложенных элементов.
Если данные имеют естественную табличную структуру с колонками и типами, предпочтительнее использовать таблицу значений. Многомерные массивы оправданы, когда нужна простая упорядоченная вложенность без накладных расходов на описание колонок.
Сравнение вариантов
Подходит для упорядоченных списков и последовательной обработки; поиск по значению требует обхода
Удобна для структурированных данных с колонками и типами, но тяжелее для простых списков
Подходит для пар «ключ-значение», но не предназначена для упорядоченного набора без ключей
Отличие от таблицы значений и структуры
Таблица значений хранит строки с одинаковым набором колонок и поддерживает типы, отбор и сортировку на уровне платформы. Массив не знает о колонках, поэтому все проверки типов и значений нужно писать в коде вручную. Выбор между ними зависит от того, нужна ли именованная схема или достаточно простого списка.
Структура удобна, когда каждый элемент имеет смысловое имя, например «Контрагент», «Дата», «Сумма». Массив не даёт такого именования, зато сохраняет строгий порядок и допускает повторяющиеся значения. Если порядок не важен, а важен быстрый доступ по ключу, структура может быть предпочтительнее.
В реальных конфигурациях часто встречаются комбинации: массив ссылок на строки таблицы значений, массив структур или таблица значений с массивом в одном из полей. Такие сочетания позволяют сочетать удобство обхода с возможностью структурированного хранения.
Частые ошибки и безопасная работа
Частая ошибка — обращение к индексу, равному или превышающему количество элементов. Перед чтением или изменением всегда проверяйте текущий размер коллекции. Если массив может быть пустым, обработка должна учитывать этот сценарий без прерывания работы.
Удаление в цикле по возрастанию индексов приводит к смещению и пропуску элементов. Безопаснее идти с конца коллекции или формировать новый массив из нужных элементов, а не изменять исходный по ходу перебора. Это снижает риск обработки не той строки или потери данных.
Не храните в массиве ссылки на объекты, которые могут быть удалены или перезаписаны в другом месте программы, без проверки их актуальности. При работе с данными, влияющими на расчёты или документы, проверяйте результат после заполнения и перед записью в базу.
Что важно запомнить
Массив удобен для списков, требует внимательной работы с индексами и не заменяет таблицу значений при структурированных данных.
Часто задаваемые вопросы
Можно ли хранить в массиве разные типы данных?
Да, элементы массива могут быть разных типов, включая числа, строки, ссылки и объекты. Однако смешанные типы усложняют обработку, поэтому перед использованием значения целесообразно проверять его принадлежность к ожидаемому типу.
Нужно ли копировать массив перед передачу в процедуру?
Если вызываемая процедура может изменять коллекцию, а исходный массив должен остаться без изменений, создайте копию заранее. В противном случае изменения внутри процедуры могут отразиться на исходном массиве.
Чем массив лучше таблицы значений?
Массив проще и легче для упорядоченных списков без фиксированных колонок. Таблица значений удобнее, когда нужны именованные поля, типы данных, отбор и встроенная сортировка.
Как избежать ошибки при удалении элементов?
Не удаляйте элементы при прямом переборе от первого к последнему. Используйте обратный порядок или собирайте нужные элементы в новый массив, чтобы индексы остальных элементов не сместились неожиданно.