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