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

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

У объекта типа «Структура» нет отдельного метода «Пустая()», как у запроса или выборки. Поэтому проверка выполняется через свойства и методы самого объекта: чаще всего через Количество(), реже — через перебор элементов или функцию Свойство(). Выбор способа зависит от того, что именно нужно узнать: отсутствие элементов вообще, отсутствие конкретного ключа или незаполненность значений.

Отдельная ситуация — когда переменная, которая должна содержать структуру, равна Неопределено. Это типичный случай для функций, которые в случае неудачи возвращают Неопределено вместо структуры. Такую переменную нужно проверять до любого обращения к методам, иначе платформа выдаст ошибку «Метод объекта не обнаружен».

Как проверить пустоту через метод Количество()

Основной и самый надёжный способ — метод Количество(). Он возвращает число элементов (пар «ключ-значение») в структуре. Если метод вернул 0, структура пуста: она создана, но в неё не добавлено ни одного свойства.

СтруктураПараметров = Новый Структура;

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

Тот же приём работает и для фиксированной структуры, и после заполнения через конструктор с параметрами. Например, Новый Структура("Контрагент, Договор") создаёт структуру с двумя ключами и значениями Неопределено — Количество() вернёт 2, хотя фактических данных в ней нет. Это важный нюанс: «пустая» и «с незаполненными значениями» — разные состояния.

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

Функция СтруктураПустая(ПроверяемаяСтруктура) Экспорт
    Если ПроверяемаяСтруктура = Неопределено Тогда
        Возврат Истина;
    КонецЕсли;
    Если ТипЗнч(ПроверяемаяСтруктура) <> Тип("Структура")
        И ТипЗнч(ПроверяемаяСтруктура) <> Тип("ФиксированнаяСтруктура") Тогда
        Возврат Истина;
    КонецЕсли;
    Возврат ПроверяемаяСтруктура.Количество() = 0;
КонецФункции

Как проверить переменную до обращения к структуре

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

1. 1
   Проверьте, что переменная не равна Неопределено
2. 2
   Убедитесь через ТипЗнч(), что это именно Структура или ФиксированнаяСтруктура
3. 3
   Вызовите Количество() и сравните результат с нулём
4. 4
   При необходимости проверьте наличие конкретных ключей через Свойство()

Функция ТипЗнч() в сочетании с Тип("Структура") защищает от ситуации, когда вместо структуры передали, например, соответствие или строку. У соответствия тоже есть метод Количество(), поэтому код может «случайно работать» — и это скрытая ошибка, которая проявится позже при обращении к свойствам.

Если Параметры = Неопределено Тогда
Возврат;
КонецЕсли;

Если ТипЗнч(Параметры) <> Тип("Структура") Тогда
ВызватьИсключение "Ожидался параметр типа Структура";
КонецЕсли;

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

Как проверить наличие конкретного ключа

Часто задача ставится иначе: не «пуста ли структура вообще», а «есть ли в ней нужное свойство». Для этого служит метод Свойство(). Он принимает имя ключа строкой и возвращает Истина, если ключ существует. Вторая форма вызова — с переменной-приёмником, куда будет помещено значение.

ЗначениеСкидки = Неопределено;
Если СтруктураПараметров.Свойство("Скидка", ЗначениеСкидки) Тогда
// Ключ есть, значение в переменной ЗначениеСкидки
Иначе
// Ключа нет — используем значение по умолчанию
ЗначениеСкидки = 0;
КонецЕсли;

Важно понимать: Свойство() проверяет наличие ключа, а не заполненность значения. Если структура создана как Новый Структура("Скидка"), ключ существует, но его значение — Неопределено. Поэтому после успешной проверки ключа часто добавляется проверка значения через ЗначениеЗаполнено() или сравнение с Неопределено.

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

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

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

Если Не ЕстьДанные Тогда
Сообщить("Структура не содержит заполненных значений");
КонецЕсли;

Такой подход применяется при валидации форм, проверке параметров отбора, подготовке данных к обмену. Учтите особенность ЗначениеЗаполнено(): для числа 0, даты '00010101' и логического Ложь функция вернёт «не заполнено». Если ноль или Ложь — легитимные значения в вашей логике, используйте сравнение с Неопределено вместо ЗначениеЗаполнено().

Сравнение способов проверки

Каждый из способов решает свою задачу, и подмена одного другим приводит к логическим ошибкам. Сводное сопоставление помогает выбрать правильный вариант под конкретное условие.

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

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

Отдельно стоит упомянуть попытку сравнить две структуры оператором =. Для структур сравнение на равенство напрямую не работает так, как ожидается, — объекты сравниваются по ссылке, а не по содержимому. Если нужно убедиться, что структура не изменилась, сравнивайте поключево или сериализуйте в JSON через ЗаписьJSON и сравнивайте строки.

Где проверка пустой структуры встречается на практике

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

Второй сценарий — функции-«сборщики» результата. Например, функция анализа документа возвращает структуру с ошибками: если Количество() = 0, документ корректен. Такой контракт удобен и легко тестируется, но требует дисциплины: функция обязана вернуть именно пустую структуру, а не Неопределено.

Третий сценарий — параметры динамических списков, отборы СКД и настройки отчётов, передаваемые между клиентом и сервером. Здесь пустая структура отборов обычно означает «показать всё без ограничений», и её нужно отличать от ситуации «отборы не инициализированы».

Как убедиться, что проверка работает правильно

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

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