Другое · 8 мин
Как присвоить тип переменной в 1С
Как присвоить тип переменной в 1С: объявление через Перем, типизация параметров функций, проверка совместимости и типичные ошибки с типами данных.
В встроенном языке 1С обычная переменная объявляется директивой Перем и не имеет жёстко закреплённого типа. Тип определяется значением, которое в переменную записано, и может меняться в ходе выполнения программы. Поэтому фраза «присвоить тип переменной» чаще означает не объявление типа, а осознанную запись значения нужного вида и проверку его соответствия.
Проверьте, присваивается ли переменной значение перед первым чтением
Можно продолжать обработку
Уточните источник значения и добавьте преобразование или прерывание
Перед работой с переменной уточните, где она объявлена: в начале модуля, в процедуре или как параметр функции. Переменные модуля видны во всех процедурах модуля, локальные — только внутри процедуры, а параметры получают значения при вызове. От места объявления зависит, как именно значение будет присвоено и какая проверка будет возможна.
- 1Объявите переменную через Перем в нужной области видимости
- 2Присвойте значение требуемого вида
- 3Проверьте тип с помощью ТипЗнч перед использованием
- 4Обработайте случай пустого или несоответствующего значения
Если нужно гарантировать, что переменная будет содержать значение определённого вида, присваивайте ей результат создания объекта, функции или выражения соответствующего типа, а затем проверяйте с помощью ТипЗнч или сравнения с Тип. Не пытайтесь изменить тип уже существующей переменной присваиванием «типа» — в языке 1С так не работает.
Как объявить переменную и чему присвоить значение
Объявление переменной в начале модуля делает её доступной для всех процедур этого модуля. Пишите Перем ИмяПеременной; без попытки указать тип после имени. После объявления переменная содержит пустое значение, пока вы не запишете в неё результат какого-либо выражения.
Присваивание значения выглядит как ИмяПеременной = Значение;. Тип переменной в момент выполнения станет типом этого значения: число, строка, дата, ссылка на справочник, документ и так далее. Если позже присвоить другое значение другого вида, переменная примет новый тип, что может привести к неочевидным ошибкам в дальнейших расчётах.
Как проверить результат
Соответствует ожидаемому типу
Отличается от ожидаемого или пустое значение
Выполняется без ошибки
Ошибка при обращении к пустой ссылке
Для работы со справочниками и документами обычно присваивают ссылку, полученную из метода ПолучитьСсылку() или через выборку. Пример:
Перем СсылкаНаНоменклатуру;СсылкаНаНоменклатуру = Справочники.Номенклатура.НайтиПоНаименованию("Товар");
После такого присваивания проверка ТипЗнч(СсылкаНаНоменклатура) должна соответствовать ожидаемому типу ссылки справочника. Если метод не нашёл объект, переменная может получить пустую ссылку, и дальнейшая работа с ней требует отдельной проверки на пустоту.
Как проверить тип значения переменной
Используйте функцию ТипЗнч(Значение) для получения типа текущего значения переменной. Результат можно сравнить с конструкцией Тип("ИмяТипа"), например Тип("СправочникСсылка.Номенклатура") или Тип("Число"). Совпадение означает, что значение имеет ожидаемый вид.
Проверку удобно разместить сразу после присваивания и перед использованием переменной в расчётах. Если тип не совпадает, прервите обработку с понятным сообщением или приведите значение к нужному виду с помощью встроенных функций преобразования, если такие применимы.
Для ссылок на объекты конфигурации полезна проверка на пустую ссылку. Пустая ссылка имеет специальное состояние, и попытка обратиться к её реквизитам без проверки вызовет ошибку выполнения. Используйте стандартные средства проверки пустоты перед доступом к свойствам объекта.
Параметры функций и процедур
Параметры процедуры и функции получают значения из вызова, поэтому их тип зависит от того, что передаст вызывающий код. В заголовке процедуры не указывается жесткий тип параметра в обычном модуле, поэтому ответственность за соответствие лежит на вызывающей стороне.
Если процедура ожидает ссылку на документ, а получит число, дальнейшие операции с реквизитами документа приведут к ошибке. Добавляйте проверку типа в начало процедуры, особенно для экспортных функций, которые могут вызываться из других модулей и форм.
Для параметров, которые должны быть обязательными, проверяйте наличие значения и тип перед началом основной логики. Не полагайтесь на то, что тип параметра останется неизменным между вызовами, если вызывающий код может меняться.
Ограничения и риски при работе с типами
В 1С нет привычного для некоторых языков строгого объявления типа переменной на весь срок её жизни. Переменная может сначала содержать число, а потом строку, если код это допускает. Это упрощает разработку, но скрывает ошибки, которые проявляются только во время выполнения.
Изменение типа в процессе работы может повредить расчётам, документам и отчётам, особенно если переменная используется в регистрах накопления или проводках. Перед изменением логики присваивания проверьте все места, где переменная читается, и протестируйте на копии базы, а не в рабочей среде.
Если переменная связана с движками документов или проводками, некорректный тип может привести к неверным остаткам и ошибкам при проведении. Ограничьте самостоятельные изменения в конфигурации случаями, когда вы можете проверить влияние на все зависимые процедуры.
Типичные ошибки и как их исправить
Одна из частых ошибок — попытка использовать переменную до присваивания. В этом случае она содержит пустое значение, и операции с ним могут дать неожиданный результат или ошибку. Всегда присваивайте начальное значение или проверяйте на пустоту перед чтением.
Другая ошибка — сравнение значений разных типов без приведения. Например, сравнение строки с числом может работать не так, как ожидается. Приводите значения к одному типу перед сравнением или используйте подходящие функции преобразования.
Также часто забывают про пустые ссылки при поиске по справочникам. Если поиск не нашёл объект, переменная не становится несуществующей, она получает пустую ссылку, и доступ к её реквизитам без проверки вызовет прерывание работы.
Когда использовать справочники, документы и перечисления
Для справочников присваивайте переменной ссылку, полученную через поиск или создание нового элемента. Для документов используйте ссылки на документы или объекты документа в зависимости от задачи: чтение реквизитов или проведение. Перечисления подходят для фиксированных наборов значений, таких как виды операций или статусы.
Выбор типа значения должен соответствовать семантике задачи. Не храните сумму в строке, а дату — в числе, даже если технически это возможно. Явное соответствие значения его смыслу упрощает отладку и снижает вероятность ошибок при переносе кода на другие конфигурации.
Если вы не уверены, какой тип должен быть у переменной, посмотрите на тип реквизита, с которым она работает, или на тип возвращаемого значения функции. Это даст более обоснованное решение, чем случайный подбор при присваивании.
ИтогЧто важно запомнить
В 1С тип переменной определяется присваиваемым значением, а не объявлением. Проверяйте тип через ТипЗнч, избегайте пустых ссылок и тестируйте изменения на копии базы.
Можно ли явно указать тип переменной при объявлении в 1С?
В обычных модулях встроенного языка переменная объявляется через Перем без указания жёсткого типа. Тип возникает в момент присваивания значения и может меняться в процессе работы.
Как узнать текущий тип переменной?
Используйте функцию ТипЗнч(ИмяПеременной) и сравните результат с конструкцией Тип("...") для ожидаемого вида значения. Это позволяет убедиться в совместимости перед дальнейшими действиями.
Что делать, если переменная получила значение не того типа?
Прервите обработку с сообщением или приведите значение к нужному виду с помощью подходящих функций преобразования. Проверьте источник значения, чтобы ошибка не повторялась при次の вызове.
Безопасно ли менять тип переменной в уже работающей конфигурации?
Изменения могут повлиять на расчёты, документы и отчёты, особенно если переменная используется в проводках или регистрах. Вносите правки осторожно, проверяйте все места использования и тестируйте на копии базы.