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