Как проверить, что значение — это структура 1С

Встроенный язык 1С не имеет отдельной функции вида «ЭтоСтруктура()», поэтому проверка типа значения выполняется через сравнение с системным типом. Самый надёжный способ — функция ТипЗнч() в сочетании с Тип("Структура"). Такая проверка нужна при разборе параметров процедур, обработке результатов обмена, работе с JSON и универсальных механизмах, где тип входящего значения заранее неизвестен.

Важно понимать, что «структура» в 1С — это конкретный встроенный тип коллекции «ключ–значение» с фиксированным набором ключей, а не любой составной объект. Соответствие, массив, таблица значений и данные формы — это другие типы, и проверка на структуру их не должна пропускать, если логика рассчитана именно на структуру.

Основной способ: сравнение через ТипЗнч и Тип

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

Типичный код проверки выглядит так:

Если ТипЗнч(ВходящееЗначение) = Тип("Структура") Тогда
// Работаем со структурой: обращаемся к ключам через точку
Сообщить(ВходящееЗначение.Свойство("Наименование"));
Иначе
ВызватьИсключение "Ожидалась структура, получен другой тип";
КонецЕсли;

Обратите внимание: имя типа указывается строкой на русском языке — "Структура". Вариант "Structure" сработает только в коде, написанном на английском синтаксисе встроенного языка, поэтому в смешанных конфигурациях лучше придерживаться одного стиля.

Функция ЭтоСтруктура(Значение) Экспорт
    Возврат ТипЗнч(Значение) = Тип("Структура");
КонецФункции

Проверка через описание типов и составной тип

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

ДопустимыеТипы = Новый ОписаниеТипов("Структура,Соответствие");
Если ДопустимыеТипы.СодержитТип(ТипЗнч(Значение)) Тогда
// Значение — структура или соответствие
КонецЕсли;

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

Чем структура отличается от соответствия и почему это важно при проверке

Частая причина ошибок — ожидание, что проверка на структуру «заодно» пропустит соответствие, ведь обе коллекции хранят пары «ключ–значение». Это не так: Тип("Структура") и Тип("Соответствие") — разные типы, и сравнение возвращает Ложь.

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

Ненадёжные способы проверки и почему их стоит избегать

В старом коде встречается проверка через строковое представление: СтрНайти(Строка(Значение), "Структура") > 0. Такой приём хрупок: строковое представление зависит от локали и не гарантирует однозначного результата, а объект другого типа теоретически может содержать похожий текст. Использовать его в новом коде не следует.

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

Проверка структуры в запросах и на клиенте

В языке запросов 1С тип проверяется иначе — оператором ССЫЛКА и функцией ТИПЗНАЧЕНИЯ(), но это применимо только к ссылочным типам и примитивам. Структура не может храниться в полях базы данных, поэтому в запросе проверка на структуру не имеет смысла: параметр-структуру в запрос передать нельзя, его даже не удастся установить через УстановитьПараметр().

На тонком и веб-клиенте проверка ТипЗнч(Значение) = Тип("Структура") работает так же, как на сервере. Но учитывайте контекст передачи: при вызове серверной процедуры с клиента структура сериализуется корректно, а вот при работе с данными формы составной объект часто оказывается ДанныеФормыСтруктура — это другой тип, и проверка на обычную структуру его не пропустит.

Практический порядок действий при разборе неизвестного значения

1. 1
   Проверьте значение на Неопределено и NULL до проверки типа — иначе последующие обращения дадут неочевидные ошибки.
2. 2
   Выполните сравнение ТипЗнч(Значение) = Тип("Структура").
3. 3
   Если допускаются смежные типы, добавьте проверки на ФиксированнаяСтруктура и Соответствие.
4. 4
   Проверьте наличие нужных ключей через метод Свойство() перед обращением к ним.
5. 5
   Только после всех проверок выполняйте основную логику обработки.

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

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

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