Как получить индекс строки таблицы значений 1С: 5 способов

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

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

Материал будет полезен как начинающим программистам 1С, так и опытным разработчикам, которые хотят оптимизировать свой код. Все примеры приведены для актуальных версий платформы (8.3.20+), но большинство методов работают и в более ранних релизах.

1. Метод Найти(): классический подход

Самый очевидный и часто используемый способ — метод Найти(). Он возвращает ссылку на найденную строку, а уже от неё можно получить индекс через свойство Индекс. Этот метод подходит, когда вы ищете строку по конкретному значению в одной из колонок.

Основной синтаксис:

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

Где:

🔹 Значение — искомое значение в колонке (может быть любым типом: строка, число, дата и т.д.)
🔹 Колонка — имя или индекс колонки, по которой ведётся поиск
🔹 НайденнаяСтрока — объект типа СтрокаТаблицыЗначений, если поиск успешен, или Неопределено, если строка не найдена

Пример с поиском по колонке "Код":

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Код");
ТЗ.Колонки.Добавить("Наименование");
ТЗ.Добавить();
ТЗ[0].Код = 100;
ТЗ[0].Наименование = "Товар 1";

НайденнаяСтрока = ТЗ.Найти(100, "Код");
Если НайденнаяСтрока <> Неопределено Тогда
Сообщить("Индекс строки: " + НайденнаяСтрока.Индекс); // Выведет: 0
КонецЕсли;

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

2. Метод Индекс(): когда строка уже известна

Если у вас уже есть ссылка на строку таблицы значений (например, после добавления или поиска), самый быстрый способ получить её индекс — использовать свойство Индекс. Это свойство доступно для любого объекта типа СтрокаТаблицыЗначений.

Преимущества метода:

🚀 Мгновенное выполнение — не требует поиска по таблице
🔗 Работает даже для строк, добавленных через Добавить() без явного указания индекса
🔄 Актуально для динамически изменяемых таблиц

Пример:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Порядок");
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Порядок = 1;

Сообщить("Индекс новой строки: " + НоваяСтрока.Индекс); // Всегда выведет последний индекс

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

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

💡

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

3. Перебор циклом: универсальный способ

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

Базовый алгоритм:

Перебираем строки таблицы в цикле Для или Пока
Для каждой строки проверяем условие (например, совпадение значений в нескольких колонках)
При нахождении нужной строки возвращаем её индекс через ТЗ.Индекс(ТекущаяСтрока)

Пример поиска по двум колонкам:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Артикул");
ТЗ.Колонки.Добавить("Цвет");

// Заполняем таблицу данными
...

ИскомыйАртикул = "ABC123";
ИскомыйЦвет = "Красный";
ИндексСтроки = -1; // Значение "не найдено"

Для Каждого Строка Из ТЗ Цикл
Если Строка.Артикул = ИскомыйАртикул И Строка.Цвет = ИскомыйЦвет Тогда
ИндексСтроки = ТЗ.Индекс(Строка);
Прервать;
КонецЕсли;
КонецЦикла;

Если ИндексСтроки = -1 Тогда
Сообщить("Строка не найдена!");
Иначе
Сообщить("Индекс: " + ИндексСтроки);
КонецЕсли;

Для больших таблиц (10 000+ строк) такой подход может быть медленным. В этом случае:

🔍 Используйте НайтиСтроки() с отбором (см. следующий раздел)
📊 Преобразуйте таблицу в ДеревоЗначений или Соответствие для ускоренного поиска
💾 Для статических данных создайте индексный массив заранее

Использовать метод Найти() для простых условий|

Прерывать цикл после нахождения строки (оператор Прервать)|

Избегать вложенных циклов по таблицам|

Для сложных условий использовать НайтиСтроки() с отбором-->

4. Метод НайтиСтроки(): поиск с отбором

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

🎯 Найти все строки, удовлетворяющие условию (не только первую)
🔄 Применить отбор по нескольким колонкам одновременно
📌 Использовать сравнения (>, <, Like и др.)

Синтаксис:

МассивСтрок = ТаблицаЗначений.НайтиСтроки(Отбор);
Для Каждого НайденнаяСтрока Из МассивСтрок Цикл
Индекс = ТаблицаЗначений.Индекс(НайденнаяСтрока);
// Обработка...
КонецЦикла;

Пример с отбором по диапазону дат:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Дата");
ТЗ.Колонки.Добавить("Сумма");

// Заполняем таблицу...

Отбор = Новый Структура;
Отбор.Вставить("Дата", Новый УсловиеОтбора("Между", НачалоДня(НачДата), КонецДня(КонДата)));

НайденныеСтроки = ТЗ.НайтиСтроки(Отбор);
Для Каждого Строка Из НайденныеСтроки Цикл
Сообщить("Индекс: " + ТЗ.Индекс(Строка) + ", Дата: " + Строка.Дата);
КонецЦикла;

Для создания сложных условий используйте объект УсловиеОтбора с операторами:

Оператор	Описание	Пример
`Равно`	Точное совпадение	`Новый УсловиеОтбора("Равно", 100)`
`Между`	Диапазон значений	`Новый УсловиеОтбора("Между", Дата1, Дата2)`
`Like`	Поиск по шаблону (с символами % и _)	`Новый УсловиеОтбора("Like", "Товар%")`
`ВГруппе`	Проверка на вхождение в массив	`Новый УсловиеОтбора("ВГруппе", МассивЗначений)`

⚠️ Внимание: Метод НайтиСтроки() создаёт новый массив строк, что может потребовать дополнительной памяти для больших таблиц. Если вам нужен только первый индекс, лучше использовать Найти() или цикл с прерыванием.

5. Работа с группировками и иерархией

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

Для работы с иерархическими таблицами:

Используйте свойство Родитель для навигации по дереву
Применяйте рекурсивный обход для поиска вложенных строк
Для получения "визуального" индекса (с учётом вложенности) используйте ПолныйИндекс()

Пример рекурсивного поиска в иерархической таблице:

Процедура НайтиИндексВИерархии(ТЗ, ИскомоеЗначение, ТекущийИндекс = 0, ТекущаяСтрока = Неопределено) Если ТекущаяСтрока = Неопределено Тогда ТекущаяСтрока = ТЗ[0]; КонецЕсли; Если ТекущаяСтрока.Наименование = ИскомоеЗначение Тогда Возврат ТекущийИндекс; КонецЕсли; // Рекурсия по дочерним строкам Если ТекущаяСтрока.ЕстьДочерниеСтроки() Тогда Для Каждого ДочерняяСтрока Из ТекущаяСтрока.Строки Цикл Результат = НайтиИндексВИерархии(ТЗ, ИскомоеЗначение, ТекущийИндекс + 1, ДочерняяСтрока); Если Результат <> Неопределено Тогда Возврат Результат; КонецЕсли; КонецЦикла; КонецЕсли; // Переход к следующей строке того же уровня СледующаяСтрока = ТЗ.СледующаяСтрока(ТекущаяСтрока); Если СледующаяСтрока <> Неопределено Тогда Возврат НайтиИндексВИерархии(ТЗ, ИскомоеЗначение, ТекущийИндекс + 1, СледующаяСтрока); Иначе Возврат Неопределено; КонецЕсли;

КонецПроцедуры

Для упрощения работы с иерархическими таблицами в 1С 8.3.20+ появился метод ПолныйИндекс(), который возвращает индекс строки с учётом вложенности. Например:

Индекс = ТЗ.ПолныйИндекс(НайденнаяСтрока); // Возвращает строку вида "0.1.2"

Как работает ПолныйИндекс()

Метод возвращает строку, где числа разделяются точками. Первое число — индекс строки верхнего уровня, второе — индекс дочерней строки и т.д.

Пример: "0.1.2" означает:

- 0 — индекс родительской строки первого уровня

- 1 — индекс дочерней строки второго уровня

- 2 — индекс строки третьего уровня

Это удобно для восстановления пути к строке в иерархии.

6. Типичные ошибки и как их избежать

Даже опытные разработчики 1С иногда сталкиваются с проблемами при работе с индексами строк. Вот наиболее распространённые ошибки и способы их решения:

Ошибка 1: Попытка получить индекс удалённой строки

Если строка была удалена из таблицы (например, через ТЗ.Удалить()), ссылка на неё остаётся, но обращение к свойству Индекс вызовет ошибку.

// Ошибочный код:
Строка = ТЗ[0];
ТЗ.Удалить(0);
Сообщить(Строка.Индекс); // ОШИБКА: Строка не принадлежит таблице

// Правильно:
Если ТЗ.НайтиСтроку(Строка) <> Неопределено Тогда
Сообщить(Строка.Индекс);
Иначе
Сообщить("Строка удалена!");
КонецЕсли;

Ошибка 2: Неучёт изменения индексов при удалении

При удалении строки все последующие строки сдвигаются вверх, и их индексы уменьшаются на 1. Если вы храните индексы в переменных, они становятся неактуальными.

ТЗ.Добавить(); // Индекс 0
ТЗ.Добавить(); // Индекс 1
ИндексПоследней = 1;
ТЗ.Удалить(0);  // Теперь строка с индексом 1 стала строкой 0
// ИндексПоследней (1) теперь указывает на несуществующую строку!

Ошибка 3: Путаница между Индекс и Позиция

В 1С есть два похожих понятия:

🔢 Индекс — порядковый номер строки (начинается с 0)
📍 Позиция — положение строки в отсортированной таблице (меняется при сортировке)

Для получения позиции используйте:

ТЗ.Сортировать("Колонка1, Колонка2");
Позиция = ТЗ.Позиция(НайденнаяСтрока);

Ошибка 4: Поиск в неинициализированной таблице

Если таблица значений пустая или не имеет колонок, методы Найти() и НайтиСтроки() вернут Неопределено, а попытка обратиться к ТЗ[0] вызовет ошибку.

ТЗ = Новый ТаблицаЗначений;
// ТЗ.Колонки.Добавить("Тест"); // Забыли добавить колонки!
Строка = ТЗ.Найти("Значение", "Колонка"); // ОШИБКА: Колонка не существует

Если ТЗ.Количество() = 0 Тогда

// Обработка пустой таблицы

КонецЕсли;-->

7. Оптимизация производительности

При работе с большими таблицами значений (тысячи строк) неоптимизированный поиск индексов может значительно замедлить выполнение кода. Вот ключевые рекомендации по оптимизации:

1. Используйте индексные структуры

Если вам часто приходится искать строки по определённому полю, создайте Соответствие (хэш-таблицу) для ускоренного доступа:

ИндексПоКоду = Новый Соответствие;
Для Каждого Строка Из ТЗ Цикл
ИндексПоКоду.Вставить(Строка.Код, ТЗ.Индекс(Строка));
КонецЦикла;

// Быстрый поиск:
Индекс = ИндексПоКоду.Получить(ИскомыйКод);

2. Избегайте многократного поиска

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

3. Используйте отбор вместо циклов

Метод НайтиСтроки() с отбором работает быстрее, чем ручной перебор в цикле, особенно для сложных условий.

4. Ограничивайте область поиска

Если вы знаете, что искомая строка находится в начале или конце таблицы, используйте методы НайтиСлева() или НайтиСправа() для ускорения:

// Поиск с начала таблицы (быстрее, если строка в первой половине)
Строка = ТЗ.НайтиСлева(Значение, "Колонка");

// Поиск с конца таблицы (быстрее, если строка в конце)
Строка = ТЗ.НайтиСправа(Значение, "Колонка");

5. Кэшируйте результаты

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

Метод	Скорость	Когда использовать
`Найти()`	⚡ Быстро	Поиск первой строки по одному полю
`Индекс()`	⚡⚡ Мгновенно	Уже есть ссылка на строку
Цикл `Для`	🐢 Медленно	Сложные условия, которые нельзя выразить через `НайтиСтроки()`
`НайтиСтроки()` с отбором	⚡⚡ Быстро	Поиск по нескольким полям или сложным условиям
Соответствие	⚡⚡⚡ Самый быстрый	Многократный поиск по одному полю

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

Можно ли получить индекс строки по нескольким колонкам без цикла?

Да, используйте метод НайтиСтроки() с составным отбором:

Отбор = Новый Структура;
Отбор.Вставить("Колонка1", 100);
Отбор.Вставить("Колонка2", "Значение");
Найденные = ТЗ.НайтиСтроки(Отбор);

Если нужна только первая строка, возьмите Найденные[0].Индекс.

Почему после сортировки таблицы индексы строк изменились?

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

ТЗ.Колонки.Добавить("ИсходныйИндекс");
Для i = 0 По ТЗ.Количество() - 1 Цикл
ТЗ[i].ИсходныйИндекс = i;
КонецЦикла;

Как получить индекс строки в таблице значений на форме?

Для таблицы значений, привязанной к элементу формы (например, ТабличноеПоле), используйте метод ТекущиеДанные:

ТекущаяСтрока = ЭлементыФормы.ТаблицаЗначений.ТекущиеДанные;
Индекс = ЭлементыФормы.ТаблицаЗначений.Индекс(ТекущаяСтрока);

Если строка не выбрана, ТекущиеДанные вернёт Неопределено.

Можно ли получить индекс строки в таблице значений по уникальному идентификатору?

В 1С нет встроенного механизма уникальных идентификаторов (UID) для строк таблицы значений. Однако вы можете:

Добавить колонку "UID" и заполнять её уникальными значениями (например, УникальныйИдентификатор())
Использовать Найти() по этому полю

Пример:

ТЗ.Колонки.Добавить("UID");
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.UID = Новый УникальныйИдентификатор();

// Поиск по UID:
UID = НоваяСтрока.UID;
НайденнаяСтрока = ТЗ.Найти(UID, "UID");

Как узнать, существует ли строка с определённым индексом?

Проверяйте количество строк в таблице перед обращением по индексу:

Если Индекс >= 0 И Индекс < ТЗ.Количество() Тогда
Строка = ТЗ[Индекс];
Иначе
Сообщить("Строка с индексом " + Индекс + " не существует!");
КонецЕсли;

Или используйте конструкцию Попытка...Исключение:

Попытка
Строка = ТЗ[Индекс];
Исключение
Сообщить("Ошибка доступа к строке: " + ОписаниеОшибки());
КонецПопытки;

Как получить индекс строки в таблице значений 1С: полное руководство