К статье
Практический материал

Другое · 8 мин

Как определить размер массива в 1С

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

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

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

Если индекс выходит за границы текущего набора, платформа выдаёт ошибку выполнения. Это главное ограничение: безопасная работа возможна только после проверки фактического количества элементов и допустимого диапазона индексов.

Что понимать под размером массива в 1С

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

Это отличается от статических массивов в некоторых других системах, где размер задаётся один раз и изменение требует создания нового объекта. В 1С один и тот же массив может использоваться в разных частях кода, и каждая часть должна полагаться на актуальное количество элементов, а не на предположение.

Как получить текущее количество элементов

Основной способ — запросить у массива текущее количество элементов в момент выполнения. Точное имя метода или свойства зависит от версии платформы и конфигурации, поэтому перед использованием стоит свериться со встроенным синтакс-помощником. В типовых примерах часто используется вызов получения количества сразу после заполнения массива.

Примерная логика может выглядеть так:

Массив = Новый Массив;
Массив.Добавить("Товар А");
Массив.Добавить("Товар Б");
ТекущийРазмер = Массив.Количество();

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

Массив только что созданКоличество элементов равно нулю

Перед первым обращением добавьте элементы или обработайте случай пустого массива

После добавления или удаленияКоличество изменилось

Получайте размер повторно, не используйте сохранённое ранее значение

Перед доступом по индексуИндекс должен быть в допустимом диапазоне

Сравните запрашиваемый индекс с текущим количеством элементов

Получение размера само по себе не защищает от ошибок, если код сразу переходит к обработке без проверки условий. Полезно зафиксировать количество элементов в переменной в начале блока, где массив не изменяется, и использовать эту переменную для всех обращений внутри этого блока.

Если массив передаётся между процедурами, не предполагайте, что вызывающая сторона сохранила его размер. Каждый получатель должен самостоятельно уточнить количество элементов на момент входа в свою логику.

Границы индексов и безопасное обращение

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

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

Если программа обрабатывает данные из внешнего источника, массив может оказаться пустым даже при успешном импорте. Проверка размера до начала обработки помогает отличить «данные отсутствуют» от «ошибка чтения».

Изменение размера в процессе выполнения

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

Порядок действий
  1. 1
    Получить текущее количество элементов массива
  2. 2
    Проверить, что массив не пуст
  3. 3
    Убедиться, что запрашиваемый индекс находится в допустимом диапазоне
  4. 4
    Выполнить обращение к элементу
  5. 5
    При изменении массива повторить проверку размера

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

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

Если массив используется в форме или отчёте, отображение может опережать обновление данных. В таких случаях размер, видимый пользователю, не всегда совпадает с размером в серверном модуле. Проверку лучше проводить там, где реально выполняется чтение или запись.

Альтернативы и выбор подходящей коллекции

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

Типичные ошибки
01
Использование размера, полученного до добавления или удаления элементов
02
Обращение к индексу, равному количеству элементов, без проверки на пустой массив
03
Изменение массива внутри цикла без пересчёта индексов

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

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

Сравнение вариантов

Массив

Подходит для упорядоченного набора и перебора по индексу; размер меняется динамически

Список значений или таблица значений

Удобнее для поиска по ключу или реквизиту; менее подходит для простого порядкового обхода

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

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

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

Итог

Что важно запомнить

Размер массива в 1С — текущее количество элементов; получайте его перед обращением, проверяйте границы индексов и пересчитывайте после любых изменений.

Часто задаваемые вопросы

Можно ли объявить массив с фиксированным размером в 1С?

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

Что будет, если обратиться к элементу с несуществующим индексом?

Платформа выдаст ошибку выполнения, так как индекс окажется вне допустимого диапазона. Проверка текущего количества элементов перед доступом помогает избежать прерывания обработки.

Нужно ли получать размер массива повторно после изменений?

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

Чем заменить массив, если нужен поиск по ключу?

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

Безопасно ли изменять массив внутри цикла по его элементам?

Только с осторожностью. Удаление или вставка меняет индексы остальных элементов, поэтому надёжнее идти от конца к началу или пересчитывать границы после каждого изменения.