Как получить индекс строки массива в 1С

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

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

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

Метод Найти(): базовый способ получить индекс

Метод Найти() принимает искомое значение и возвращает индекс первого совпавшего элемента. Если совпадений нет, результат — Неопределено, поэтому его всегда нужно проверять перед использованием в индексации массива.

Массив = Новый Массив;
Массив.Добавить("Яблоко");
Массив.Добавить("Груша");
Массив.Добавить("Слива");

Индекс = Массив.Найти("Груша");
Если Индекс <> Неопределено Тогда
Сообщить("Найдено на позиции: " + Индекс); // 1
Иначе
Сообщить("Элемент не найден");
КонецЕсли;

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

Индекс = Массив.Найти(ИскомоеЗначение);
Если Индекс = Неопределено Тогда
    // элемент отсутствует
КонецЕсли;

Перебор массива с индексом в цикле

Когда критерий поиска сложнее точного равенства — например, частичное совпадение строки или сравнение с приведением типов — используют цикл по индексам. Верхняя граница массива возвращается методом ВГраница(), он равен Количество() - 1.

Для Индекс = 0 По Массив.ВГраница() Цикл
Если СтрНайти(НРег(Массив[Индекс]), НРег("груша")) > 0 Тогда
Сообщить("Найдено на позиции: " + Индекс);
Прервать;
КонецЕсли;
КонецЦикла;

Альтернатива — цикл Для Каждого с отдельной переменной-счётчиком. Такой вариант удобен, когда элемент нужен не только для проверки, но и для дальнейшей работы:

Индекс = -1;
Для Каждого Элемент Из Массив Цикл
Индекс = Индекс + 1;
Если Элемент = ИскомоеЗначение Тогда
Прервать;
КонецЕсли;
КонецЦикла;

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

Поиск индекса структуры по значению поля

Частая задача: массив содержит структуры (например, строки данных), и нужно найти позицию элемента по значению одного из ключей. Метод Найти() здесь не поможет — структуры сравниваются по ссылке на объект, а не по содержимому полей, поэтому поиск почти всегда вернёт Неопределено.

Решение — перебор с обращением к полю структуры:

// Массив структур вида: Новый Структура("Код, Наименование", ...)
ИндексНайденного = Неопределено;
Для Индекс = 0 По МассивСтруктур.ВГраница() Цикл
Если МассивСтруктур[Индекс].Код = ИскомыйКод Тогда
ИндексНайденного = Индекс;
Прервать;
КонецЕсли;
КонецЦикла;

Если под «строкой массива» имеется в виду таблица значений

В практике разработчиков под «строками массива» иногда подразумевают строки таблицы значений или табличной части. Это другие коллекции, и у них свои методы поиска. У таблицы значений применяют Найти() (по значению колонки), НайтиСтроки() (по структуре отбора) и Индекс() для определения позиции уже найденной строки.

Строка = ТаблицаЗначений.Найти(ИскомыйКод, "Код");
Если Строка <> Неопределено Тогда
ИндексСтроки = ТаблицаЗначений.Индекс(Строка);
КонецЕсли;

У табличной части документа у строки есть свойство НомерСтроки — оно начинается с единицы, в отличие от индекса. Для получения индекса строки табличной части используют НомерСтроки - 1 или метод Индекс() табличной части.

Оптимизация: соответствие вместо повторного перебора

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

Индексы = Новый Соответствие;
Для Индекс = 0 По Массив.ВГраница() Цикл
Индексы.Вставить(Массив[Индекс], Индекс);
КонецЦикла;

// Дальше поиск — мгновенно:
Индекс = Индексы[ИскомоеЗначение]; // Неопределено, если нет

Такой приём оправдан, когда поисков больше нескольких десятков или массив большой. Для разового поиска в небольшом массиве достаточно Найти() — усложнение кода не даст заметного выигрыша.

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

Отдельно стоит удаление элементов в цикле. Если нужно удалить несколько элементов по условию, перебирайте массив с конца — от ВГраница() к нулю. Тогда удаление текущего элемента не сдвинет позиции ещё не проверенных:

Для Индекс = -Массив.ВГраница() По 0 Цикл
РеальныйИндекс = -Индекс;
Если Массив[РеальныйИндекс] = УдаляемоеЗначение Тогда
Массив.Удалить(РеальныйИндекс);
КонецЕсли;
КонецЦикла;

Проверка результата

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

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