Как проверить тип значения в 1С 8

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

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

Ниже разобраны основные способы проверки типа с примерами кода, типичные ошибки и рекомендации, какой вариант выбрать в конкретной ситуации.

Основной способ: функции ТипЗнч и Тип

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

Стандартная конструкция проверки выглядит так:

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

Имена типов указываются без пробелов и точно так, как они определены в конфигурации: СправочникСсылка.ИмяСправочника, ДокументСсылка.ИмяДокумента, ПеречислениеСсылка.ИмяПеречисления, Число, Дата, Булево, Строка. Ошибка в имени приведёт к исключению при выполнении функции Тип().

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

Проверка ссылочных и примитивных типов

Подход к проверке немного отличается в зависимости от того, что ожидается: ссылка на объект базы данных или примитивное значение.

Проверка примитивных типов

Для примитивов — Число, Строка, Дата, Булево — достаточно прямого сравнения. Учтите, что Неопределено и NULL — это тоже типы, и их часто нужно отсекать первыми:

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

Если ТипЗнч(Значение) = Тип("Число") Тогда
// арифметика безопасна
КонецЕсли;

Отдельная тонкость: пустая дата и пустая строка — это всё ещё значения типов Дата и Строка. Проверка типа не заменяет проверку заполненности через ЗначениеЗаполнено().

Проверка ссылок

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

Если Справочники.ТипВсеСсылки().СодержитТип(ТипЗнч(Значение)) Тогда
// это ссылка на какой-то справочник
КонецЕсли;

Аналогично работают Документы.ТипВсеСсылки(), Перечисления.ТипВсеСсылки(), ПланыСчетов.ТипВсеСсылки() и другие менеджеры. Это удобно, когда нужно отличить «любую ссылку» от примитивного значения, не перечисляя все виды объектов.

Проверка через ОписаниеТипов и метод СодержитТип

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

МассивТипов = Новый Массив;
МассивТипов.Добавить(Тип("СправочникСсылка.Контрагенты"));
МассивТипов.Добавить(Тип("СправочникСсылка.Организации"));
Допустимые = Новый ОписаниеТипов(МассивТипов);

Если Допустимые.СодержитТип(ТипЗнч(Значение)) Тогда
// тип значения входит в список допустимых
КонецЕсли;

Также полезно помнить, что у реквизита объекта метаданных уже есть готовое описание типов. Его можно получить через метаданные и проверить, допускает ли реквизит конкретное значение:

ОписаниеРеквизита = Метаданные.Документы.РеализацияТоваровУслуг.Реквизиты.Контрагент.Тип;
Если ОписаниеРеквизита.СодержитТип(ТипЗнч(Значение)) Тогда
// значение можно безопасно записать в реквизит
КонецЕсли;

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

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

Проверка типа по строковому представлению

Иногда функцию Тип() использовать нельзя: например, код должен работать в конфигурациях, где нужного объекта метаданных может не быть, или имя типа приходит извне в виде строки. В таких случаях сравнивают строковое представление типа:

Если Строка(ТипЗнч(Значение)) = "Номенклатура" Тогда
// ...
КонецЕсли;

У этого способа есть ограничения. Строковое представление зависит от синонима объекта метаданных, который могут переименовать, и отличается для разных категорий типов. Более надёжный вариант — получить полное имя через метаданные для ссылочных значений:

Если Справочники.ТипВсеСсылки().СодержитТип(ТипЗнч(Значение)) Тогда
ИмяТипа = Значение.Метаданные().ПолноеИмя(); // например, "Справочник.Номенклатура"
КонецЕсли;

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

Проверка типа в запросах

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

ВЫБРАТЬ
Регистр.Значение
ИЗ
РегистрСведений.ЗначенияСвойств КАК Регистр
ГДЕ
Регистр.Значение ССЫЛКА Справочник.Номенклатура
И ТИПЗНАЧЕНИЯ(Регистр.Значение) = ТИП(Справочник.Номенклатура)

Для составных полей полезна функция ВЫРАЗИТЬ() — она приводит значение к указанному типу, и если приведение невозможно, результатом будет NULL или пустая ссылка. Это позволяет безопасно обращаться к реквизитам через точку без ошибок соединения.

Помните, что обращение через точку к реквизиту составного поля без ВЫРАЗИТЬ() порождает соединения со всеми таблицами возможных типов, что заметно замедляет запрос на больших объёмах данных.

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

Какой способ выбрать в разных ситуациях

Выбор зависит от контекста: где выполняется код, насколько он универсален и что именно нужно проверить.

Для обычной прикладной логики в модулях почти всегда достаточно прямого сравнения через ТипЗнч и Тип — это самый быстрый и читаемый вариант. К ОписаниеТипов переходите, когда список допустимых типов больше двух-трёх или формируется динамически. Строковые сравнения оставляйте для расширений и универсальных обработок.

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

Ограничения и подводные камни

Функция ТипЗнч() не работает в управляемых формах на клиенте для некоторых серверных типов — например, объектов данных, доступных только на сервере. В тонком и веб-клиенте многие типы недоступны в принципе, и попытка сравнения с ними вызовет ошибку компиляции или выполнения. Проверки таких типов выносите в серверные процедуры.

Ещё одна ловушка — различие между ссылкой и объектом. Значение, полученное методом ПолучитьОбъект(), имеет тип СправочникОбъект.Имя, а не СправочникСсылка.Имя. Сравнение со ссылочным типом даст Ложь. Если процедура может принимать и то, и другое, проверяйте оба варианта или приводите значение к ссылке через свойство Ссылка.

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

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