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

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

Первая строка таблицы значений имеет индекс 0, потому что коллекция строк индексируется с нуля. Обратиться к ней можно напрямую через оператор квадратных скобок, через метод Получить() или через цикл с немедленным прерыванием. Каждый способ имеет свои условия применения и подводные камни.

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

Обращение к первой строке по индексу

Самый короткий и распространённый способ — прямое обращение по индексу. Коллекция строк таблицы значений поддерживает оператор «[]», поэтому достаточно написать:

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

Переменная ПерваяСтрока получит тип «СтрокаТаблицыЗначений». Через неё доступны все колонки по имени: ПерваяСтрока.Сумма, ПерваяСтрока.Контрагент и так далее. Также значение колонки можно получить через метод Получить() с индексом колонки: ПерваяСтрока.Получить(2).

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

Метод Получить() и его особенности

Альтернатива квадратным скобкам — метод Получить() коллекции строк. Он принимает индекс и возвращает строку таблицы значений:

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

По результату метод Получить(0) эквивалентен обращению ТЗ[0]. Разница скорее стилистическая: квадратные скобки короче и привычнее для большинства разработчиков, а Получить() иногда используют в коде, где индекс вычисляется динамически и хочется подчеркнуть, что это вызов метода коллекции.

Оба способа одинаково требовательны к границам: при передаче индекса вне диапазона от 0 до Количество()-1 платформа выдаст ошибку «Индекс находится за границами массива». Метод не возвращает Неопределено для несуществующего индекса — только исключение.

Получение первой строки через цикл

Третий вариант — обойти таблицу циклом и прервать его после первой итерации:

Для Каждого Строка Из ТЗ Цикл
    ПерваяСтрока = Строка;
    Прервать;
КонецЦикла;

Такой приём выглядит громоздко для простой задачи, но у него есть практический смысл. Если таблица пуста, цикл просто не выполнится ни разу, и переменная ПерваяСтрока останется неопределённой — ошибки не возникнет. Это встроенная защита от пустой таблицы без явной проверки Количество().

Цикл с Прервать также удобен, когда «первая строка» определяется условием: например, первая строка с заполненной суммой или с нужным признаком. В этом случае перед Прервать добавляется проверка условия, и код остаётся компактным.

Проверка таблицы на пустоту перед обращением

Стандартный безопасный шаблон выглядит так: сначала проверяется количество строк, затем выполняется обращение. Проверять лучше именно через Количество() > 0 — это явно и читаемо.

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

Ещё один вариант защитного программирования — инициализировать переменную значением Неопределено, а после получения строки проверять её:

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

Если ПерваяСтрока <> Неопределено Тогда
    // работа со строкой
КонецЕсли;

1. 1
   Убедитесь, что переменная содержит таблицу значений, а не Неопределено
2. 2
   Проверьте ТЗ.Количество() > 0
3. 3
   Получите строку: ПерваяСтрока = ТЗ[0]
4. 4
   Обратитесь к нужной колонке по имени: ПерваяСтрока.ИмяКолонки
5. 5
   Проверьте значение колонки на пустое, если оно может быть не заполнено

Типичные ошибки при получении первой строки

Самая частая ошибка — обращение ТЗ[0] без проверки на пустоту. В отладке на тестовых данных всё работает, а в реальной базе таблица оказывается пустой, и пользователь получает окно с ошибкой. Второй типичный сценарий — обращение к несуществующей колонке: если написать ПерваяСтрока.Колонка, которой нет в таблице, платформа выдаст ошибку «Поле объекта не обнаружено».

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

Практические сценарии использования

Единственная строка результата запроса

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

Первая строка после сортировки

Частая задача — найти строку с максимальным или минимальным значением. Простое решение: отсортировать таблицу методом Сортировать("Сумма Убыв") и взять ТЗ[0] — это будет строка с максимальной суммой. Признак результата — значение в нужной колонке соответствует ожидаемому экстремуму.

Заполнение реквизитов формы из первой строки

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

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

После получения строки полезно убедиться, что она содержит ожидаемые данные. Минимальная проверка — значения ключевых колонок не пустые. Если колонка может содержать Неопределено или пустую ссылку, используйте ЗначениеЗаполнено() перед дальнейшей обработкой.

В отладчике строку таблицы значений удобно инспектировать через табло: добавьте выражение ТЗ[0] и раскройте его — будут видны все колонки и значения. Так можно быстро убедиться, что получена именно та строка, которая ожидалась, особенно после сортировки или отбора.

Часто задаваемые вопросы