Как узнать количество элементов массива в 1С

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

Массив в 1С — динамическая структура: его размер меняется по мере добавления и удаления элементов, поэтому количество элементов нельзя «запомнить» один раз и использовать дальше без проверки. Каждый раз, когда логика зависит от размера массива, значение нужно запрашивать заново — вызов метода Количество() выполняется быстро и не создаёт заметной нагрузки.

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

Метод Количество(): синтаксис и примеры

Метод вызывается у переменной, содержащей массив, и возвращает значение типа Число. Параметров у метода нет.

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

Размер = МойМассив.Количество(); // Размер = 3

Если массив только что создан и в него ничего не добавляли, метод вернёт 0. Это нормальное поведение, а не ошибка — пустой массив является корректным объектом.

ПустойМассив = Новый Массив;
Если ПустойМассив.Количество() = 0 Тогда
Сообщить("Массив пуст");
КонецЕсли;

Метод Количество() можно использовать непосредственно в условиях и выражениях, не сохраняя результат в переменную: Если МойМассив.Количество() > 10 Тогда .... Однако если значение нужно несколько раз внутри одного участка кода и массив при этом не меняется, удобнее сохранить его в переменную для читаемости.

Проверка массива на пустоту перед обработкой

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

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

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

Обратите внимание: проверка Количество() = 0 не заменяет проверку самой переменной. Если переменная не инициализирована (имеет значение Неопределено), вызов метода вызовет ошибку. Надёжная конструкция выглядит так:

Если Массив = Неопределено Или Массив.Количество() = 0 Тогда
Возврат;
КонецЕсли;

Обход массива по индексу с использованием Количество()

Индексация массива в 1С начинается с нуля. Последний элемент имеет индекс Количество() - 1. Классический цикл обхода выглядит так:

Для Индекс = 0 По МойМассив.Количество() - 1 Цикл
Элемент = МойМассив[Индекс];
Сообщить("Элемент " + Индекс + ": " + Элемент);
КонецЦикла;

Если массив пуст, верхняя граница цикла будет равна -1, цикл не выполнится ни разу — это безопасно, дополнительная проверка не требуется.

Когда индекс элемента не нужен, проще использовать цикл Для Каждого — он короче и исключает ошибки с границами:

Для Каждого Элемент Из МойМассив Цикл
Сообщить(Элемент);
КонецЦикла;

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

Для Индекс = 1 По МойМассив.Количество() Цикл
ТекущийИндекс = МойМассив.Количество() - Индекс;
Если МойМассив[ТекущийИндекс] = Неопределено Тогда
МойМассив.Удалить(ТекущийИндекс);
КонецЕсли;
КонецЦикла;

// Количество элементов массива
Массив = Новый Массив;
Массив.Добавить("А");
Массив.Добавить("Б");
Сообщить(Массив.Количество()); // 2
Сообщить(Массив.ВГраница());    // 1 — индекс последнего элемента

Метод ВГраница(): индекс последнего элемента

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

Метод удобен в циклах, потому что убирает арифметику «минус один» и снижает риск ошибки:

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

Запомнить разницу просто: Количество() отвечает на вопрос «сколько элементов», ВГраница() — «какой индекс у последнего». Путать их нельзя: если использовать Количество() как верхний индекс, обращение Массив[Массив.Количество()] вызовет ошибку выхода за границы.

Количество элементов в других коллекциях 1С

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

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

Если функция должна принимать разные типы коллекций, проверяйте тип через ТипЗнч() перед вызовом метода — у строки, числа или значения Неопределено метода Количество() нет.

Производительность и особенности клиент-серверного режима

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

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

&НаКлиенте
Процедура ОбработатьНажатие(Команда)
Если ВыбранныеСтроки.Количество() = 0 Тогда
ПоказатьПредупреждение(, "Не выбрано ни одной строки");
Возврат;
КонецЕсли;
ОбработатьНаСервере(ВыбранныеСтроки);
КонецПроцедуры

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

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

В конфигураторе размер массива виден прямо в отладчике: при остановке на точке останова наведите курсор на переменную или добавьте её в табло — рядом со значением «Массив» отображается количество элементов.

Быстрый способ проверить размер без остановки выполнения — вывести значение через Сообщить() или записать в журнал регистрации для серверного кода:

Сообщить("Получено элементов: " + МассивРезультатов.Количество());

Вычислить выражение можно и в окне «Вычислить выражение» (Shift+F9) во время отладки: введите МойМассив.Количество() — отладчик покажет текущее значение. Это удобно, когда нужно проверить размер массива в середине цикла, где он меняется.

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