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