С какого значения начинается индексирование элементов коллекции в 1С

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

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

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

Как устроена индексация в 1С

Встроенный язык 1С использует нулевую (zero-based) индексацию: отсчёт позиций в коллекции ведётся от нуля. Это соглашение закреплено на уровне платформы и одинаково работает в толстом, тонком и веб-клиенте, а также на сервере.

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

Массив = Новый Массив;
Массив.Добавить("Первый");
Массив.Добавить("Второй");
Массив.Добавить("Третий");

Сообщить(Массив[0]); // "Первый"
Сообщить(Массив[2]); // "Третий"
Сообщить(Массив.ВГраница()); // 2 — индекс последнего элемента

Индексация в основных коллекциях

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

Массив

Доступ по квадратным скобкам: Массив[0] — первый элемент. Метод ВГраница() возвращает индекс последнего элемента, что удобно для циклов от конца к началу. Методы Вставить() и Удалить() также принимают индекс с отсчётом от нуля.

Таблица значений и табличная часть

Строки таблицы значений доступны по индексу: ТаблицаЗначений[0] — первая строка. То же справедливо для табличных частей документов и справочников: Документ.Товары[0] — первая строка табличной части. При этом свойство НомерСтроки у этой же строки будет равно 1.

Список значений и дерево значений

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

Индекс и номер строки: в чём разница

Главный источник ошибок — смешение программного индекса и пользовательского номера строки. НомерСтроки у строки табличной части начинается с 1 и отображается пользователю в интерфейсе. Индекс этой же строки в коллекции — 0. Связь простая: НомерСтроки = Индекс + 1, но полагаться на неё стоит осторожно.

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

Безопасное обращение к элементам по индексу

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

1. 1
   Проверьте, что коллекция существует и заполнена: Количество() > 0.
2. 2
   Убедитесь, что индекс в диапазоне от 0 до Количество() - 1.
3. 3
   Для поиска элемента используйте Найти() или НайтиСтроки() — они не выбрасывают исключение при отсутствии результата.
4. 4
   При обходе предпочитайте цикл Для Каждого — он исключает ошибки индексации.
5. 5
   Если нужен цикл по индексу, используйте Для Инд = 0 По Коллекция.Количество() - 1 Цикл.

Если ТаблицаТоваров.Количество() > 0 Тогда
    ПерваяСтрока = ТаблицаТоваров[0];
КонецЕсли;

// Обход по индексу с конца (для безопасного удаления строк)
Для Инд = 0 По ТаблицаТоваров.Количество() - 1 Цикл
    Строка = ТаблицаТоваров[ТаблицаТоваров.Количество() - 1 - Инд];
    Если Строка.Сумма = 0 Тогда
        ТаблицаТоваров.Удалить(Строка);
    КонецЕсли;
КонецЦикла;

Типичные ошибки при работе с индексами

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

Как проверить корректность кода

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

Частые вопросы