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

Другое · 6 мин

Индексация элементов коллекции в 1C: с какого значения начинается отсчёт

В статье объяснено, с какого значения начинается индексирование элементов коллекции в 1C, как правильно обходить массивы и таблицы значений, и какие ошибки избегать.

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

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

Отсчёт индексов в коллекциях 1C

В коллекциях 1C отсчёт начинается с единицы, поэтому первый элемент массива доступен по индексу 1. Это относится к массивам, созданным через конструктор Новый Массив, а также к многим встроенным коллекциям, возвращаемым методами объектов конфигурации. Индекс последнего элемента всегда равен общему количеству элементов в коллекции.

Если в коде используется конструкция типа Массив[0], платформа выдаст ошибку, так как элемента с нулевым индексом не существует. Аналогично, обращение к индексу, равному Количество() + 1, выходит за границы коллекции. Такие ситуации легко обнаружить при отладке, но лучше исключить их ещё на этапе написания кода.

Почему отсчёт ведётся с единицы

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

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

Организация циклов по элементам

Самый безопасный способ обойти коллекцию — использовать цикл For Each, при котором отдельно указывать индекс не требуется. В этом случае платформа сама перебирает все элементы в порядке их нахождения в коллекции, и риск ошибки с индексом отсутствует.

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

Порядок безопасного обхода
  1. 1
    Определите количество элементов с помощью Количество()
  2. 2
    Запустите цикл от 1 до этого значения включительно
  3. 3
    Обращайтесь к элементу по текущему индексу внутри цикла
  4. 4
    Проверьте результат после завершения обхода

При использовании индекса важно не путать количество элементов с максимально допустимым индексом. В 1C эти значения совпадают, но логика доступа должна быть строго в пределах от 1 до Количество(). Любое выходное значение за этот диапазон считается ошибочным.

Таблицы значений и коллекции

Строки таблицы значений также индексируются с единицы, если обращение к ним выполняется по числовому индексу. Первый ряд таблицы имеет индекс 1, а последний — индекс, равный количеству строк. Это справедливо для методов получения строк и для операций вставки или удаления по позиции.

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

Типичные ошибки и последствия

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

Использование значения Количество() как индекса последнего элемента допустимо, но попытка обращения к индексу, большего на единицу, вызывает ошибку. Также опасным является изменение коллекции во время обхода: добавление или удаление элементов может сдвинуть индексы остальных строк и привести к пропуску или повторной обработке данных.

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

Проверка границ и безопасная работа

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

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

Контрольные точки

Как проверить результат

Количество элементов в коллекции
Норма

Значение больше нуля и совпадает с ожидаемым

Тревожный признак

Ноль или несоответствие ожидаемому количеству

Индекс обращения
Норма

В интервале от 1 до Количество()

Тревожный признак

Равен нулю или превышает Количество()

Результат обхода
Норма

Все элементы обработаны без ошибок

Тревожный признак

Ошибка выхода за границы массива в журнале

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

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

Итог

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

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

С какого значения начинается индексация массива в 1C?

Индексация начинается с единицы. Первый элемент массива доступен по индексу 1, а последний — по индексу, равному общему количеству элементов.

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

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

Нужно ли при переносе кода с других языков сдвигать индексы?

Да, все ссылки на элементы коллекции, написанные для языков с нулевой индексацией, следует скорректировать с учётом отсчёта с единицы в 1C.

Как безопасно перебрать все элементы коллекции?

Используйте цикл For Each, если порядковый индекс не обязателен. Если индекс нужен, организуйте цикл от 1 до Количество() включительно и проверяйте границы перед доступом.