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

Другое · 6 мин

Как обойти массив в 1С:Предприятии

Обход массива в 1С:Предприятии через цикл Для каждого и по индексу, проверка пустоты, безопасная обработка, типичные ошибки и выбор подходящего способа.

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

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

Когда обход массива нужен в 1С

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

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

Обход циклом «Для каждого»

Цикл «Для каждого» позволяет перебрать все элементы массива в порядке их следования без указания индексов. В теле цикла доступен текущий элемент, с которым можно выполнять проверки, вычисления или запись результатов в другие объекты.

Обработка строк табличной части

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

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

Обход по индексу

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

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

Проверка на пустоту и границы

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

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

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

Изменение массива во время обхода

Удаление или добавление элементов во время обхода массива изменяет его состав и может сдвинуть позиции оставшихся элементов. При использовании цикла «Для каждого» это часто приводит к пропуску элементов или повторной обработке одной и той же строки.

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

Порядок действий
  1. 1
    Проверьте, что переменная содержит массив и определите количество элементов.
  2. 2
    Выберите цикл «Для каждого» для последовательной обработки или цикл по индексу, если нужен номер элемента.
  3. 3
    Обработайте каждый элемент и сохраните результат в отдельную переменную или таблицу.
  4. 4
    Проверьте результат после завершения цикла, особенно если массив мог быть пустым.

Сравнение способов и выбор варианта

Цикл «Для каждого» проще в написании и менее подвержен ошибкам с границами, но не дает номера элемента. Цикл по индексу дает контроль над позицией и удобен для удаления элементов, но требует внимательной проверки границ и корректной инициализации счетчика.

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

Итог

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

Выбирайте способ обхода в зависимости от задачи, проверяйте массив на пустоту и границы перед доступом по индексу, а при изменении состава массива работайте с копией или обходите с конца к началу.

Какой цикл выбрать для обхода массива?

Используйте цикл «Для каждого», когда нужно просто последовательно обработать все элементы. Выбирайте обход по индексу, если нужен порядковый номер элемента, доступ к соседней строке или остановка по позиции.

Что делать, если массив пуст?

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

Можно ли удалять элементы массива во время обхода?

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

Как проверить, что обход завершился корректно?

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