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