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

Работа с коллективными типами данных является неотъемлемой частью разработки на платформе 1С:Предприятие 8. Программистам постоянно приходится сталкиваться с необходимостью обработки списков, массивов и таблиц значений. Одной из базовых задач в этом процессе является определение размера коллекции, то есть подсчет того, сколько именно объектов в ней содержится. От этого значения часто зависит логика выполнения циклов, условия ветвления и валидация входящих данных перед записью в базу.

В отличие от некоторых других языков программирования, где для массивов и списков могут использоваться разные свойства или методы, в языке 1С существует универсальный подход. Однако новички часто совершают ошибки, пытаясь найти несуществующие свойства типа Count или Length, характерные для C# или Java. Понимание правильного способа получения количества элементов критически важно для написания стабильного и производительного кода, который не будет выдавать ошибки выполнения в продакшене.

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

Основной метод подсчета элементов

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

Синтаксис функции предельно прост: в качестве единственного аргумента передается имя переменной, содержащей коллекцию. Функция возвращает целочисленное значение типа Число, равное количеству элементов. Если массив пуст, функция вернет ноль.

Рассмотрим классический пример объявления массива и получения его размера. Сначала мы создаем новый объект типа Массив, затем наполняем его произвольными данными и только после этого вызываем функцию подсчета. Такой порядок действий гарантирует, что мы работаем с валидным объектом.

МойМассив = Новый Массив();
МойМассив.Добавить("Элемент 1");
МойМассив.Добавить("Элемент 2");
МойМассив.Добавить("Элемент 3");

Количество = СтрЧислоСтрок(МойМассив);
Сообщить("В массиве элементов: " + Количество);

Использование функции СтрЧислоСтрок является стандартом де-факто в сообществе разработчиков 1С. Это связано с тем, что данный метод оптимизирован на уровне платформы и работает быстрее, чем любые попытки реализовать подсчет вручную через циклы. Кроме того, этот подход обеспечивает читаемость кода: любой другой разработчик, увидев эту функцию, мгновенно поймет намерение автора.

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

Обработка пустых и неинициализированных массивов

Одной из самых распространенных причин возникновения ошибок в коде 1С является работа с неинициализированными переменными. Если вы объявили переменную, но не присвоили ей значение нового массива, она имеет значение Неопределено. Прямой вызов функции СтрЧислоСтрок() для такой переменной приведет к критической ошибке выполнения, которая остановит работу скрипта или обработчика.

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

Альтернативный подход заключается в использовании конструкции Попытка..Исключение. Этот метод считается более "ленивым", но иногда удобным, если вы ожидаете, что переменная в большинстве случаев будет корректной. Однако для проверки количества элементов явное условие предпочтительнее с точки зрения производительности и чистоты кода.

🛡️ Всегда проверяйте переменную на значение Неопределено перед использованием.

🔍 Используйте функцию ТипЗнч() для строгой типизации проверки.

⚡ Избегайте лишних вызовов функций внутри условий, если значение уже известно.

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

Если ТипЗнч(ВозможныйМассив) = Тип("Массив") Тогда Размер = СтрЧислоСтрок(ВозможныйМассив); Иначе Размер = 0;
КонецЕсли;

☑️ Безопасная работа с массивами
Объявить переменнуюИнициализировать новым МассивомПроверить тип перед доступомИспользовать СтрЧислоСтрокОбработать пустой случай
Выполнено: 0 / 5

Сравнение с другими типами коллекций

Платформа 1С:Предприятие предлагает богатый выбор коллективных типов данных, и важно понимать различия в подходах к ним. Хотя функция СтрЧислоСтрок() является универсальной, некоторые объекты имеют собственные методы или свойства для получения количества элементов, использование которых может быть более семантически верным в конкретных ситуациях.

Например, объект СписокЗначений также полностью поддерживает функцию СтрЧислоСтрок(), но у него есть метод Количество(). Аналогично, ТаблицаЗначений имеет метод Количество(), который возвращает число строк. Использование специфичных методов часто делает код более понятным при чтении, так как сразу ясно, с каким типом данных мы работаем.

Тем не менее, для типа Массив собственного метода Количество() не существует. Попытка вызвать МойМассив.Количество() приведет к ошибке "Метод объекта не обнаружен". Поэтому для массивов функция СтрЧислоСтрок остается единственным корректным вариантом.

⚠️ Внимание: Не путайте тип данных Массив с объектом метаданных ПланСчета или другими справочниками. У объектов метаданных могут быть свои методы получения количества элементов, но к обычным переменным-массивам они не применимы.

В таблице ниже приведено сравнение способов получения количества элементов для различных популярных коллекций в 1С. Это поможет вам быстро сориентироваться при написании кода для разных типов данных.

Тип коллекции Основной метод Альтернатива Особенности

Массив СтрЧислоСтрок() Нет Единственный способ

СписокЗначений СтрЧислоСтрок() Количество() Метод более читаем

ТаблицаЗначений СтрЧислоСтрок() Количество() Возвращает число строк

ФиксированныйМассив СтрЧислоСтрок() Нет Размер неизменяем

Почему нет свойства Count?
Исторически сложилось, что в языке 1С методы часто имеют префикс или название, описывающее действие (СтрЧислоСтрок), а не свойство объекта. Это отличает 1С от объектно-ориентированных языков вроде C# или Java, где свойство Count является стандартом для коллекций.

Итерация по массиву с использованием размера

Знание количества элементов массива чаще всего требуется для организации циклов. В 1С существует два основных способа перебора массива: цикл Для Каждого и цикл Для.. Из.. По. Первый вариант предпочтителен для простого чтения данных, так как он менее многословен и защищен от ошибок выхода за границы диапазона.

Однако цикл с счетчиком (Для.. Из.. По) незаменим, когда вам нужно знать индекс текущего элемента или когда требуется удалять элементы из массива в процессе перебора. В таких случаях использование функции СтрЧислоСтрок() в условии цикла является обязательным.

При удалении элементов из массива во время итерации Если вы идете по массиву от начала к концу, вы можете пропустить элементы, так как индексы сдвинутся. Правильной стратегией в таком случае является перебор в обратном порядке: от СтрЧислоСтрок(Массив) - 1 до 0.

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

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

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

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

Вопрос производительности функции СтрЧислоСтрок() часто волнует разработчиков, работающих с высоконагруженными системами. Хорошая новость заключается в том, что эта функция работает за константное время O(1). Внутренняя структура массива в 1С хранит информацию о своем размере, поэтому функции не нужно пробегать по всем элементам для их подсчета. Она просто возвращает сохраненное значение.

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

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

🚀 Функция работает мгновенно, так как размер хранится в метаданных массива.

📉 Нет необходимости кэшировать значение для однократного использования.

🔄 При многократном использовании в тесных циклах кэширование полезно.

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

⚠️ Внимание: Хотя функция быстрая, избыточное усложнение кода ради микро-оптимизации часто снижает его поддерживаемость. Оптимизируйте только те участки кода, которые реально влияют на производительность системы.

📊 Как вы чаще всего получаете размер массива?
СтрЧислоСтрок()
Свойство Количество (ошибка)
Цикл с счетчиком
Не знаю

Типичные ошибки разработчиков

Даже опытные программисты иногда допускают досадные промахи при работе с массивами в 1С. Самая частая ошибка — это попытка использовать синтаксис других языков. Разработчики, пришедшие из мира JavaScript или C#, по инерции пишут Массив.Length или Массив.Count, что неизбежно приводит к ошибке компиляции или выполнения.

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

Также стоит упомянуть ошибку работы с Неопределено. Если массив передается в функцию как параметр, и там он не инициализирован, то проверка Если Массив <> Неопределено Тогда обязательна. Игнорирование этого правила — верный путь к нестабильной работе конфигурации.

Ниже приведен список проверок, которые стоит внедрить в свою практику код-ревью, чтобы избегать этих проблем:

❌ Проверка отсутствия использования свойств Count или Length для массивов.

✅ Гарантия, что индексация не выходит за пределы 0.. N-1.

🛡️ Наличие проверок на Неопределено перед вызовом СтрЧислоСтрок.

Ошибка "Индекс за границей диапазона"
Эта ошибка возникает, когда вы пытаетесь прочитать или записать значение по индексу, которого не существует. Например, в массиве из 3 элементов (индексы 0, 1, 2) обращение к элементу [3] вызовет эту ошибку. Всегда помните про вычитание единицы при расчете последнего индекса.

Заключение и лучшие практики

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

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

Помните, что чистота и понятность кода часто важнее микро-оптимизаций. Используйте стандартные средства платформы, документируйте свои решения и всегда тестируйте граничные случаи, такие как пустые массивы или неинициализированные переменные. Это сэкономит вам часы отладки в будущем.

Можно ли использовать СтрЧислоСтрок для Таблицы Значений?

Да, функция СтрЧислоСтрок() универсальна и работает с Таблицей Значений, возвращая количество строк в ней. Однако у Таблицы Значений есть собственный метод Количество(), который часто используется как более читаемая альтернатива.

Что вернет функция, если передать ей пустой массив?

Если массив был создан (инициализирован), но в него не добавлено ни одного элемента, функция СтрЧислоСтрок() вернет число 0. Ошибки не возникнет, так как пустой массив — это валидный объект.

Почему возникает ошибка при вызове СтрЧислоСтрок(Неопределено)?

Функция ожидает на входе объект типа Коллекция (Массив, Список, Таблица). Значение Неопределено не является коллекцией, поэтому платформа не может определить количество элементов и выдает ошибку выполнения.

Как получить индекс последнего элемента массива?

Индекс последнего элемента всегда равен СтрЧислоСтрок(Массив) - 1. Поскольку индексация начинается с нуля, вычитание единицы из общего количества элементов дает правильный индекс.

Тип коллекции	Основной метод	Альтернатива	Особенности
Массив	`СтрЧислоСтрок()`	Нет	Единственный способ
СписокЗначений	`СтрЧислоСтрок()`	`Количество()`	Метод более читаем
ТаблицаЗначений	`СтрЧислоСтрок()`	`Количество()`	Возвращает число строк
ФиксированныйМассив	`СтрЧислоСтрок()`	Нет	Размер неизменяем

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

Основной метод подсчета элементов

Обработка пустых и неинициализированных массивов

☑️ Безопасная работа с массивами

Сравнение с другими типами коллекций

Итерация по массиву с использованием размера

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

Типичные ошибки разработчиков

Заключение и лучшие практики

📖 Читайте также